Mapping Shopify Fields

Title (required)

The main name for your product that is displayed to your customers

Example: "Rover 14 Backpack"

Match with a short text attribute.

The title is used to create your product handles - if no custom handle is defined.

The title has a maximum limit of 255 characters.

Handle

The product’s unique identifier in Shopify
Example: "rover-14-backpack"

Match with a short text attribute.

When creating a new product from Plytix PIM and the handle is either left blank or unmatched, the handle will be automatically generated based on the attribute you matched to the title field. If you sell on multiple stores, we recommend using a custom handle per store. 

Handles have a maximum limit of 255 characters and only support lowercase, numbers, and hyphens. Special characters are not supported.

A product description that supports HTML

Example: "A lightweight 14L backpack perfect for the back country."

Indicates whether your product is ready to be sold (active), not ready yet (draft), or no longer available to customers (archived).

Accepted values: 

active

draft

archived

Example: "active"

Match with a dropdown that contains the accepted values. 

You can also use formulas to transform the Plytix "Status" system attribute into an acceptable Shopify format:

DLOOKUP($STATUS, {"Draft": "draft", "Completed": "active", "Archived": "archived"}, "draft")

A true/false field that controls whether your product is published in Shopify. 

Accepted values:

true

false

Example: "false"

Match with a boolean attribute, or a short text or dropdown attribute with the accepted values. 

Use the Published Scope field to choose specific sales channels.

If you're using the Published At field to schedule a product, make sure the Published field is mapped and set to true; otherwise, the scheduling won't work.

A custom categorization used for filtering and searching products.

Example: "Sport Backpack"

Typically matched with the system attribute categories. Make sure to set your "Category Path" export settings to 'Last Child'.

The maximum length for a custom product type is 255 characters.

Mapping the field to a blank attribute will remove the value from your product. 

A categorization for the product based on Shopify's Standard Product Taxonomy. 

Example: "ap-2" (This value represents the category "Animals & Pet Supplies > Pet Supplies").

Adds products to a manual collection in Shopify.

Example: "Best Sellers"

Match with a short text, multiselect, dropdown attribute.

A string of comma-separated keywords associated with your product used for filtering and search.

Example: "14L,Board Bag,Hydration"

Match with a multiselect attribute.

A product can have up to 250 tags. Each tag has a maximum limit of 255 characters.

Mapping the field to a blank attribute will remove the tags from your product. 

The name of the product's vendor

Example: "Nitro"

Match with a short text or dropdown attribute.

The maximum length for a vendor field is 255 characters.

Mapping the field to a blank attribute will assign the store name as a vendor. 

Images related to the product.

Match with a Media Gallery attribute.

The suffix of the Liquid template used for the product page. 

If this property is specified, then the product page uses a template called "product.suffix.liquid", where "suffix" is the value of this property. 

If this property is "" or null, then the product page uses the default template "product.liquid". (default: null)

Match with a short text or dropdown attribute.

The date and time (ISO 8601 format) when the product is scheduled to be published.

The date will display until it is reached or replaced with a new date. A past date publishes immediately when synced.

Example: "2007-12-31T19:00:00-05:00"

Match with a date attribute. 

Ensure the Published field is mapped and set to true; otherwise, changes to the Published At field will not be applied.

Specifies the sales channels where the product will be available.

Accepted values:

web

global

web: The product is published to the Online Store channel but not published to the Point of Sale channel.

global: The product is published to both the Online Store channel and the Point of Sale channel.

Example: "web"

Match with a dropdown attribute that uses the accepted values.

Ensure the Published field is mapped and set to true; otherwise, changes to the Published Scope field will not be applied.  

Option Name (1-3)

(Required to create variant products in your store)

The name of the product options your variants vary by, such as size, color.. 

Example: "Size"

Match with a short text or dropdown attribute. 

You can also create formulas with a string value defined. 

This value is shown over the available options in the Shopify store. The option names must be defined on the parent product.

You can add up to 3 options.

Featured image

The main image that identifies your product.

Mapping it ensures each product and variation has a unique featured image.

Match with a media single attribute (eg your thumbnail). 

Option Value (1-3)

(at least one required for variant products)

The values for the option names your products come in. 

Example: "Small", “Medium”, “Large”

Match with a short text, multiselect, or dropdown attribute.

The option values must be defined on all of your variant products.

These values can be up to 255 characters each.

The order in which your variant options are shown on your product page

Match with an integer type attribute.

If you choose to use a decimal type attribute, only the value before the decimal point will be used for sorting.

A unique identifier for the product variants in the store.

Required in order to connect to a Fulfillment Service.

Example: "NITROROVER14"

Match with the SKU or another unique identifier in a short text attribute.

The barcode, UPC, or ISBN number for the product.

Example: "1234_pink"

Match with a short text or the Plytix GTIN attribute.

The price of the product variant

Example: "199.00"

Match with a decimal attribute with a dot separator.

You can also create a formula for special price configurations. 

The original price of the item before an adjustment or a sale.

Example: "299.00"

Match with a decimal attribute with a dot separator.

You can also create a computed attribute for special price configurations.

The price that the item costs the seller (used along with Price for tracking profit margins). 

Example: "110.50"

Match with a decimal attribute.

Must be a positive number.

Mapping the field to a blank attribute will not remove the price from your product. Instead, the value needs to be set to “0”. 

Whether a tax is charged when the product variant is sold.

Accepted values: 

true

false

Example: "true"

This field is only applicable to stores that have the Avalara AvaTax app installed. This specifies the Avalara tax code for the product variant

Example: "DA040000"

The fulfillment service that tracks the number of items in stock for the product variant.

Accepted values:

shopify

null

enabled

or the handle of a fulfillment service

shopify: You are tracking inventory yourself using the admin.

null: You aren't tracking inventory on the variant.

enabled: This must be the same fulfillment service referenced by the fulfillment_service property.

Example: null

Whether customers are allowed to place an order for the product variant when it's out of stock.

Accepted values:

deny

continue

deny: Customers are not allowed to place orders for the product variant if it's out of stock. (default)

continue: Customers are allowed to place orders for the product variant if it's out of stock.

Example: "continue"

The weight of the product variant in the unit system specified in the weight unit field.

Example: "100"

Match with a decimal attribute.

The unit of measurement that applies to the product variant's weight.

Accepted values: 

• g
• kg
• oz
• lb

Example: "oz"

Match with a dropdown attribute that has the accepted values.

A code designating a country or region according to this list.

Example: "US"

Match with a short text or dropdown attribute.

A code between six and thirteen digits that is used for shipping products internationally which can be searched for here.

Example: 0902109015

Match with a short text attribute.

Depending on the country your products are shipped to, the length of your tariff code may differ.

Mapping the field to a blank attribute will remove the value from your product.