Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Value types

Type

Description

Boolboolean

A true or false value or use numbers 0 and 1.

Example: “true”

Colorcolor

The hexadecimal code for a color including leading # char.

Example: “#fff123”

Datedate

A date in ISO 8601 format without a presumed time zone.

Example: “2021-02-02”

DateTimedate_time

A date and time in ISO 8601 format without a presumed time zone.

Example: “2021-01-01T12:30:00”

Decimaldimension

A number with decimal places in the range of +/-9999999999999.999999999.

Example: “10.4”

Dimension

A number value and a unit. Unit is by default the unit at the Perfion Feature, but can be set via an attribute @ShopifyUnit or the value can be a json string like { "unit": "cm", "value": 25.0 }

Valid unit values: in, ft, yd, mm, cm, m.

Example: 25.0 or { "unit": "cm", "value": 25.0 }

Integermoney

Int

A whole number in the range of +/-9,007,199,254,740,991.

Example: “10”

JsonA numeric value and a unit for the currency code that matches the store's currency. Unit is by default the unit at the Perfion Feature, but can be set via an attribute @ShopifyUnit or the value can be a json string like { "amount": "5.99", "currency_code": "CAD" }

Valid unit values: currency code in the shop.

Example: 5.99 or { "amount": "5.99", "currency_code": "CAD" }

json

A JSON-formatted string.

Example: “[{ "k": "v1" }, { "k": "v2" }]”

MultiLineTextmulti_line_text_field

 

A multi-line text field.

Example: “Item list:

Table

Chair”Rating

number_decimal

A number with decimal places in the range of +/-9999999999999.999999999.

Example: “10.4”

number_integer

A whole number in the range of +/-9,007,199,254,740,991.

Example: “10”

rating

A rating measured on a specified scale. This is a JSON-formatted string.

Example: { "value": "3.5", "scale_min": "1.0", "scale_max": "5.0" }

SingleLineTextrich_text_field

A rich text field supporting headings, lists, links, bold, and italics as json string. Learn more about rich text formatting.

single_line_text_field

 

A single-line text field.

Example: “Some text”

Urlurl

A URL with one of the allowed schemes: https, http, mailto, sms, tel.

Example: “Start and grow your e-commerce business - 3-Day Free Trial

Volumevolume

A number value and a unit. Unit is by default the unit at the Perfion Feature, but can be set via an attribute @ShopifyUnit or the value can be a json string like { "unit": "cm", "value": 25.0 }

Valid unit values: ml, cl, l, m3 (cubic meters), us_fl_oz, us_pt, us_qt, us_gal, imp_fl_oz, imp_pt, imp_qt, imp_gal.

Example: 25.0 or { "unit": "ml", "value": 20.0 }

Weightweight

A number value and a unit. Unit is by default the unit at the Perfion Feature, but can be set via an attribute @ShopifyUnit or the value can be a json string like { "unit": "cm", "value": 25.0 }

Valid unit values: oz, lb, g, kg

Example: 25.0 or { "unit": "ml", "value": 20.0 }

...

Reference types

Type

Description

PageRefpage_reference

A reference to a page on the online store. This is a special Shopify URL.

Example: “gid://shopify/OnlineStorePage/1”

ProductRefproduct_reference

A reference to a product on the online store. This is a special Shopify URL.

Example: “gid://shopify/Product/1”

VariantRefvariant_reference

A reference to a product variant on the online store. This is a special Shopify URL.

Example: “gid://shopify/ProductVariant/1”

FileReffile_reference

A reference to a file on the online store. This is a special Shopify URL.

Example: “gid://shopify/MediaImage/123”

List types

List metafields enable you to store multiple values in a single metafield by using a Multi Feature in Perfion. The maximum number of values that can be stored in a metafield list is 128. The following types support Shopify List type by alling “list.” in the start og the type like “list.single_line_text_field”:

  • list.color

  • list.date

  • list.date_time

  • list.dimension

  • list.file_reference

  • list.number_decimal

  • list.number_integer

  • list.page_reference

  • list.product_reference

  • list.rating

  • list.single_line_text_field

  • list.url

  • list.variant_reference

  • list.volume

  • list.weight