How to Troubleshoot Discrepancies in Product Metafields

When product metafields show unexpected or incorrect values, the issue is usually related to mapping, formatting, validation, content type, or conflicting metafields. Below are the common causes and steps you can take to resolve discrepancies.

1. Confirm Metafield Mapping

If a metafield is not mapped in your feed settings, Stock Sync will not update it. This can lead to situations where:

• A variant metafield updates correctly
• A product metafield still shows an old value

To fix this:

• Open your feed mapping settings
• Ensure the metafield namespace and key are correctly assigned to the intended column
• If the metafield key is missing from the mapping dropdown, it may require a technical update before it becomes available
• Re-run the feed

2. Check for Conflicting Metafields

A metafield in your store may conflict with your feed update process. This can block or override updates.

To resolve this:

• Temporarily remove or disable the problematic metafield
• Re-run the feed to confirm the issue is resolved

3. Verify the Content Type and Validation

The metafield definition in Shopify must match the value sent by the feed. Use Decimal for numerical values, True or False for boolean values, and Single line text for text values. Also check validation rules: for example, a minimum value of 1 will reject a feed value of 0. Adjust or remove the validation rule if the incoming value should be allowed.

4. Verify Value Formatting in the Source File

Some metafields may update incorrectly if the value format does not match Shopify's requirements.

Example observed:

• Values like "$1,000" may be split at the comma, resulting in only "1" being saved

To fix this:

• Remove commas from numeric metafield values (e.g., use "1000" instead of "1,000")
• Ensure the column contains clean and consistent formatting
• Re-run the feed

5. Test the Update

Run a test update using a few sample SKUs with Stock Sync’s Filter feature before performing a full sync. Verify the metafield values in the Shopify admin after the test.

6. When to Escalate

Escalate for technical investigation if multiple metafields consistently display incorrect values, the same formatting works for most products but fails for specific ones, or the metafield key is unavailable in the mapping dropdown. Providing sample SKUs/barcodes and screenshots helps with investigation.

Updated on: 27/07/2026