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.

How to Configure Metafield Matching
Go to App → Feed Settings → Step 2: Matching Column
- Select Identifier: In the matching field dropdown, choose Metafield instead of SKU or Barcode.
- Enter Namespace and Key: Provide the exact Shopify metafield definition following the
namespace.keyformat (e.g.,custom.supplier_id). - Map the Source Column: Select the feed file column that contains the corresponding identifier values.
- Save and Test: Save your feed settings and test the connection to verify that products match correctly.
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.
- 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
- [Updating Stock Using Metafield as Identifier] → Detailed walkthrough on setting up product and variant metafields as primary sync identifiers.
Updated on: 03/11/2026
Thank you!
