Versions Compared

Key

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

...

Mapping to field

Output Kind

Description

Metafield|<namespace>|<key>

Metafield|<namespace>|<key>|<type>

Metafield|<namespace>|<key>|<type>|<name>

Field

Product metafield parameter. “namespace” and “key” combined value must be unique.

namespace” must have min 2 chars, max 20 chars and allowed characters are: A-Za-z0-9_.~-@#*$.

key” must have min 3 chars, max 30 chars and allowed characters are A-Za-z0-9_.~-@#*$

type” parameter may have many values. Refer to Metafield Handling in order to see all supported values. Type is optional. If not defined the ‘string’ type will be used by default.

name” parameter is the name for the Metafield Definition

Metafield|<namespace>|<key>|<type>|<name>@ShopifyUnit

Attribute

Get units from a string feature instead of using Perfion Feature Unit or json format.

This only works for Dimension,

Value types

Type

Description

Bool

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

Example: “true”

Color

The hexadecimal code for a color including leading # char.

Example: “#fff123”

Date

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

Example: “2021-02-02”

DateTime

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

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

Decimal

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 }

Integer

Int

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

Example: “10”

Json

A JSON-formatted string.

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

MultiLineText

 

A multi-line text field.

Example: “Item list:

Table

Chair”

Decimal

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

Example: “10.4”

Integer

Int

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" }

SingleLineText

 

A single-line text field.

Example: “Some text”

PageRef

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

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

ProductRef

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

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

VariantRef

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

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

FileRef

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

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

Url

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

BoolVolume

A true or false value. One can also use numbers 0 and 1.

Example: “true”

Weight

A value and a unit of weight. Valid unit values: oz, lb, g, kg. This is a JSON-formatted string.

Example: “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": "kgcm", "value": 225.5 0 }Volume

A value and a unit of volume. Valid unit values:  mlml,  clcl,  ll,  m3 m3 (cubic meters),  usus_fl_oz,  usus_pt,  usus_qt,  usus_gal,  impimp_fl_oz,  impimp_pt,  impimp_qt,  impimp_gal. This is a JSON-formatted string.Example: .

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

Weight

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

PageRef

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

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

ProductRef

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

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

VariantRef

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

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

FileRef

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

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