product

Properties

Anchor to

available

boolean

Returns true if at least one of the variants of the product is available. Returns false if not.

For a variant to be available, it needs to meet one of the following criteria:

• The variant.inventory_quantity is greater than 0.
• The variant.inventory_policy is set to continue.
• The variant.inventory_management is nil.
• The variant has an associated delivery profile with a valid shipping rate.

Anchor to

category

taxonomy_category

The taxonomy category for the product

Anchor to

collections

array of collection

The collections that the product belongs to.

Note

Collections that aren't available on the Online Store sales channel aren't included.

Anchor to

compare_at_price

number

The lowest compare at price of any variants of the product in the currency's subunit.

The value is output in the customer's local (presentment) currency.

For currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.

Tip

Use money filters to output a formatted price.

Anchor to

compare_at_price_max

number

The highest compare at price of any variants of the product in the currency's subunit.

The value is output in the customer's local (presentment) currency.

For currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.

Tip

Use money filters to output a formatted price.

Anchor to

compare_at_price_min

number

The lowest compare at price of any variants of the product in the currency's subunit. This is the same as product.compare_at_price.

The value is output in the customer's local (presentment) currency.

For currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.

Tip

Use money filters to output a formatted price.

Anchor to

compare_at_price_varies

boolean

Returns true if the variant compare at prices of the product vary. Returns false if not.

Anchor to

content

string

The description of the product.

Note

This is the same value as product.description.

Anchor to

created_at

string

A timestamp for when the product was created.

Tip

Use the date filter to format the timestamp.

Anchor to

description

string

The description of the product.

Note

This is the same value as product.content.

Anchor to

featured_image

image

The first (featured) image attached to the product.

Anchor to

featured_media

media

The first (featured) media attached to the product.

Tip

You can use media filters to output media URLs and displays. To learn about how to include media in your theme, refer to Support product media.

Anchor to

first_available_variant

variant

The first available variant of the product.

For a variant to be available, it needs to meet one of the following criteria:

• The variant.inventory_quantity is greater than 0.
• The variant.inventory_policy is set to continue.
• The variant.inventory_management is nil.

Anchor to

gift_card?

boolean

Returns true if the product is a gift card. Returns false if not.

Anchor to

handle

string

The handle of the product.

Anchor to

has_only_default_variant

boolean

Returns true if the product doesn't have any options. Returns false if not.

Anchor to

id

number

The ID of the product.

Anchor to

images

array of image

The images attached to the product.

Anchor to

media

array of media

The media attached to the product, sorted by the date it was added to the product.

Tip

You can use media filters to output media URLs and displays. To learn about how to include media in your theme, refer to Support product media.

Anchor to

metafields

The metafields applied to the product.

Tip

To learn about how to create metafields, refer to Create and manage metafields or visit the Shopify Help Center.

Anchor to

options

array of string

The option names of the product.

Example

Output the options

You can use the size filter with dot notation to determine how many options a product has.

CodeData

Reset Code

9

1

2

3

4

5

{% if product.options.size > 0 -%}

{% for option in product.options -%}

- {{ option }}

{%- endfor %}

{%- endif %}

{% if product.options.size > 0 -%} {% for option in product.options -%} - {{ option }} {%- endfor %} {%- endif %}{ "product": { "options": [ "Size", "Strength" ] } }

Output

9

1

2

- Size

- Strength

Anchor to

options_by_name

Allows you to access a specific product option by its name.

Example

Output the values for a specific option

When accessing a specific option, the name is case-insensitive.

CodeData

Reset Code

9

1

2

3

4

5

6

7

8

<label>

Strength

<select>

{%- for value in product.options_by_name['strength'].values %}

<option>{{ value }}</option>

{%- endfor %}

</select>

</label>

<label> Strength <select> {%- for value in product.options_by_name['strength'].values %} <option>{{ value }}</option> {%- endfor %} </select> </label>{ "product": { "options_by_name": {} } }

Output

9

1

2

3

4

5

6

7

8

<label>

Strength

<select>

<option>Low</option>

<option>Medium</option>

<option>High</option>

</select>

</label>

Anchor to

options_with_values

array of product_option

The options on the product.

Anchor to

price

number

The lowest price of any variants of the product in the currency's subunit.

Note

This is the same value as product.price_min.

The value is output in the customer's local (presentment) currency.

For currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.

Tip

Use money filters to output a formatted price.

Anchor to

price_max

number

The highest price of any variants of the product in the currency's subunit.

The value is output in the customer's local (presentment) currency.

For currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.

Tip

Use money filters to output a formatted price.

Anchor to

price_min

number

The lowest price of any variants of the product in the currency's subunit.

Note

This is the same value as product.price.

The value is output in the customer's local (presentment) currency.

For currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.

Tip

Use money filters to output a formatted price.

Anchor to

price_varies

boolean

Returns true if the product's variant prices vary. Returns false if not.

Anchor to

published_at

string

A timestamp for when the product was published.

Tip

Use the date filter to format the timestamp.

Anchor to

quantity_price_breaks_configured?

boolean

Returns true if the product has at least one variant with quantity price breaks in the current customer context. Returns false if not.

Anchor to

requires_selling_plan

boolean

Returns true if all of the variants of the product require a selling plan. Returns false if not.

Note

A variant requires a selling plan if variant.requires_selling_plan is true.

Anchor to

selected_or_first_available_selling_plan_allocation

selling_plan_allocation

The currently selected, or first available, selling plan allocation.

The following logic is used to determine which selling plan allocation is returned:

Selling plan allocation	Return criteria
The currently selected allocation	Returned if a variant and selling plan are selected. The selected variant is determined by the variant URL parameter, and the selected selling plan is determined by the selling_plan URL parameter.
The first allocation on the first available variant	Returned if no allocation is currently selected.
The first allocation on the first variant	Returned if no allocation is currently selected, and there are no available variants.

If the product doesn't have any selling plans, then nil is returned.

Anchor to

selected_or_first_available_variant

variant

The currently selected or first available variant of the product.

Note

The selected variant is determined by the variant URL parameter. The selected_variant parameter is available on product pages only.

For a variant to be available, it needs to meet one of the following criteria:

• The variant.inventory_quantity is greater than 0.
• The variant.inventory_policy is set to continue.
• The variant.inventory_management is nil.

Anchor to

selected_selling_plan

selling_plan

The currently selected selling plan.

If no selling plan is selected, then nil is returned.

Note

The selected selling plan is determined by the selling_plan URL parameter.

Anchor to

selected_selling_plan_allocation

selling_plan_allocation

The currently selected selling plan allocation for the currently selected variant.

If no variant and selling plan are selected, then nil is returned.

Note

The selected variant is determined by the variant URL parameter, and the selected selling plan is determined by the selling_plan URL parameter.

Anchor to

selected_variant

variant

The currently selected variant of the product.

If no variant is currently selected, then nil is returned.

Note

The selected variant is determined by the variant URL parameter. This URL parameter is available on product pages URLs only.

Anchor to

selling_plan_groups

array of selling_plan_group

The selling plan groups that the variants of the product are included in.

Anchor to

tags

array of string

The tags of the product.

Note

The tags are returned in alphabetical order.

Anchor to

template_suffix

string

The name of the custom template of the product.

The name doesn't include the product. prefix, or the file extension (.json or .liquid).

If a custom template isn't assigned to the product, then nil is returned.

Anchor to

title

string

The title of the product.

Anchor to

type

string

The type of the product.

Anchor to

url

string

The relative URL of the product.

If a product is recommended, then the URL contains tracking parameters:

Copy

9

1

/products/gorgeous-wooden-computer?pr_choice=default&pr_prod_strat=description&pr_rec_pid=13&pr_ref_pid=17&pr_seq=alternating

Anchor to

variants

array of variant

The variants of the product.

Note

Returns a maximum of 250 variants when unpaginated. Tip: Use the paginate tag to choose how many variants to show per page, up to a limit of 50.

Anchor to

variants_count

number

The total number of variants for the product.

Anchor to

vendor

string

The vendor of the product.