Articles on: Frequently Asked Questions (FAQ)

Can I map a metafield for updating stock?

Yes, syncX: Stock Sync allows you to map custom Shopify metafields as your matching product identifier. This feature enables you to update inventory, pricing, and product details using custom reference keys instead of relying solely on standard SKUs or Barcodes.


Using metafields is ideal when your supplier uses unique internal catalog IDs or when your store tracks multi-source identifiers without altering standard SKUs.




How to Configure Metafield Matching


Go to App → Feed Settings → Step 2: Matching Column


  1. Select Identifier: In the matching field dropdown, choose Metafield instead of SKU or Barcode.
  2. Enter Namespace and Key: Provide the exact Shopify metafield definition following the namespace.key format (e.g., custom.supplier_id).
  3. Map the Source Column: Select the feed file column that contains the corresponding identifier values.
  4. Save and Test: Save your feed settings and test the connection to verify that products match correctly.


Ensure the identifier column in your supplier file contains unique values for every product or variant to prevent cross-updating.



Key Rules & Technical Details


  • Namespace & Key Formatting: The metafield must be entered exactly as configured in your Shopify admin under Settings → Custom data (case-sensitive).
  • Variant vs. Product Scope: If your products contain variants with independent inventory levels, configure the metafield at the Variant level in Shopify rather than the product level.
Priority rule: Stock Sync matches products against the selected identifier column first before applying any quantity rules, pricing rules, or field updates.
  • Matching Precedence: If a feed row has an empty or unmatched metafield value, Stock Sync will automatically skip the item and log it in the feed process report.



Troubleshooting Steps


  • Issue: The feed runs but skips all products without updating inventory. → Solution: Verify that the metafield namespace and key in Stock Sync match your Shopify settings exactly, including casing and punctuation (e.g., custom.vendor_sku).
  • Issue: All variants under a product update to the same inventory count. → Solution: Check your Shopify metafield definition. Move the metafield to the Variant level so each variant can hold a unique identifier.
  • Issue: Products with empty metafield values fail to update. → Solution: Populate the missing metafield values in Shopify or use standard SKU matching for items that do not yet have metafield data assigned.



Good Articles to Continue


Updated on: 03/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!