metafield_text

metafield | metafield_text

Generates a text version of the data from a metafield object.

Note

The metafield_text filter doesn't currently support list metafields other than list.single_line_text_field and list.metaobject_reference.

Anchor to Basic types

Basic types

The following outlines the output for each metafield type:

Metafield type	Output
`single_line_text_field`	The metafield text.
`multi_line_text_field`	The metafield text.
`page_reference`	The page title.
`product_reference`	The product title.
`collection_reference`	The collection title.
`variant_reference`	The variant title.
`file_reference`	The file URL.
`number_integer`	The number.
`number_decimal`	The number.
`date`	The date.
`date-time`	The date and time.
`url`	The URL.
`json`	The JSON.
`boolean`	The boolean value.
`color`	The color value.
`weight`	The weight value and unit. If the value is a decimal with more than two places, then it'll be formatted to have a precision of two with trailing zeros removed.
`volume`	The volume value and unit. If the value is a decimal with more than two places, then it'll be formatted to have a precision of two with trailing zeros removed.
`dimension`	The dimension value and unit. If the value is a decimal with more than two places, then it'll be formatted to have a precision of two with trailing zeros removed.
`rating`	The rating value.
`list.single_line_text_field`	The metafield values in sentence format. For example, if you had the values `Toronto`, `Ottawa`, and `Vancouver`, then the output would be: `Toronto, Ottawa, and Vancouver`
`money`	The money value, formatted using the store's HTML with currency setting.
`rich_text_field`	The rich text value as simple text.

Output

Potion dosages

Output

Potion dosages

Anchor to Complex types

Complex types

The following metafield types produce different output depending on the provided field parameter:

Anchor to list.metaobject_reference

list.metaobject_reference

metafield | metafield_text: field: string

Outputs the list of metaobjects in sentence format. The required field parameter specifies which field should be rendered for each metaobject. The field parameter can reference only metafields of type single_line_text_field.

{{ product.metafields.information.ingredients | metafield_text: field: 'name' }}

Output

Spinach, Kale, and Mushrooms

Output

Spinach, Kale, and Mushrooms

Anchor to metaobject_reference

metaobject_reference

metafield | metafield_text: field: string

Outputs the metafield text for the metaobject field specified by the required field parameter. The field parameter can reference only metafields of type single_line_text_field.

{{ product.metafields.information.primary_ingredient | metafield_tag: field: 'name' }}

Output

<span class="metafield-single_line_text_field">Spinach</span>

Output

<span class="metafield-single_line_text_field">Spinach</span>

Was this page helpful?

metafield_text

Basic types

Code

Data

Output

Output

Complex types

list.metaobject_reference

Code

Data

Output

Output

metaobject_reference

Code

Data

Output

Output