What Fields Does Athos Commerce Pull From Shopify?

In generating a data feed from your Shopify store, we pull five types of fields from Shopify:

1. Core fields
2. Variant fields
3. Tags
4. Metafields
5. Metaobjects

Core Fields

Core fields are the default fields that Shopify creates when you add a new product to your store. These fields include, but are not limited to, Title, Description, Image, Product Type, and Vendor. Essentially, the basic information about the product you are adding.

Core fields are the most necessary fields for us to generate a successful data feed.
If you export your product database to a CSV file, Shopify will generate titles for each of the fields. We have listed the core fields that we require on the left and the related Shopify field on the right.

• Unique ID: this is pulled from the id field
• Product Name: this is pulled from the title field
• Product URL: Athos Commerce generates a custom field for this by grabbing the handle field and inputting it into the following url: http://sitename.myshopify.com/products/%handle%
• Price: this is pulled from the variant_price field (notice: this is a variant field, but is created by Shopify whenever a product is created)
• image: this is pulled from the image field

Athos will grab this information to generate the required core fields for indexing your data.

Variant Fields

Variants are user-defined variations of a product, such as color options and available sizes. When you create a product in Shopify, you can add these variations under the Variants tab.

Note that variants are treated as unique products, with individual records stored for each variant.

Athos has the ability to grab this variant data to use for searching, creating filters or sort options. Samples of variant fields generated by Athos from provided Shopify data:

• color
• size
• finish
• fabric

Note: Each variant you create in Shopify will generate its own field in the data feed.

Tags

If you’re looking to build filters using your Shopify tags, Athos needs the data to be structured in a specific way to work its magic. You can find the formatting guide here.

Note: Tag data is combined into one field in your data, with the Key:Value pairs separated with commas (Material:Brass,Thread_Size:3/4,Shape:Octagonal). 

Metafields

Metafields are a great way to store additional important information about a product, such as instructions for washing. For instructions on creating Metafields from Shopify, click here.

Tip: We strongly recommend limiting the number of products with metafields to 20,000 or fewer, as this can drastically increase the time it takes your store's data to sync with Athos.

Metafields contain the following user-defined information: Namespace, Key, and Value.

When Athos grabs metafield data, it creates a field with this name: mfield_namespace_key

The value is the information pulled in for that field. 

Sample image from MetaFields Editor:

The result of the first metafield above would be a field name of mtfld_product_best_seller and the value would be "false".

Metaobjects

Metaobjects in Shopify allow you to define custom data types for your store beyond the default objects like products and collections. Each metaobject can have its own set of fields, making it easy to create structured content tailored to your specific business needs such as product highlights, designer profiles, or size guides.

To learn how to create and use metaobjects in Shopify, click here.

If you are referencing metaobjects as a metafield value within your Shopify store, Athos will be able to retrieve and utilize the associated metaobject data to power your integration and enhance the shopper experience.