What is the process to update metafields in Shopify using Stock Sync?

To map a feed column to a metafield:

1. Create the metafield in Shopify Admin first: Settings → Metafields and metaobjects. Define its namespace and key, owner (Product or Variant), and content type.
2. In Stock Sync, open the feed and go to Step 2: Matching Column.
3. Click Add more field and select Custom Data (Metafield).
4. Select the existing metafield from the dropdown. The selector shows its owner and content type. If it is not listed, enter the namespace and key manually in namespace.key format, such as custom.brand.
5. Select the feed column that should populate the metafield. A fixed value can be used when the source column is not present and the same value should apply to all products.
6. Check the metafield settings, then save and run a test sync.

Map Product and Variant metafields separately. A mapped Variant metafield does not update the similarly named Product metafield, and a Product metafield requires a product-level identifier/record. The Shopify definition and the Stock Sync content type must match the feed value. Basic types such as text, numbers, dates, URLs, JSON, and true/false are supported; reference types, including Product, Page, File, Variant, Metaobject, and list-based references, are not supported.

If the save page freezes or the import fails, test only one or two metafield mappings at a time and check the feed's Error Log to identify the failing mapping. Make changes in a copy of the feed rather than the original. Stock Sync stores metafield values in Shopify; how they appear on the storefront is controlled by the Shopify theme or custom code.

Updated on: 06/08/2026