Articles on: Frequently Asked Questions (FAQ)

How can I troubleshoot if I have the error list file provided?

If your feed's Activity Log shows an Error List file, some updates failed to apply. This guide explains how to download the file, understand the errors it lists, and fix the most common ones.



How to Download and Review the Error List


  1. Open the Activity Log: Go to your feed's Activity Log and find the run that shows an Error List file.
  2. Download the file: Download the Error List to see which products were affected and why their updates failed.
  3. Check the error types: Match each error in the file to one of the examples below.



Common Error Types and How to Resolve Them


1. NON_MUTABLE_INVENTORY_ITEM

The inventory item is part of a parent bundle that cannot be updated through the Shopify API.


How to resolve it:

  • Review the affected bundle product in your Shopify store.
  • Exclude the product with the Store Product Filter if you do not want Stock Sync to update it.
  • Alternatively, delete and re-import the product, if that suits your setup.
  • If you need help identifying the affected products, contact our support team.


2. ITEM_NOT_STOCKED_AT_LOCATION

The inventory item is not stocked at the selected location, or it is linked to a fulfillment service location that Stock Sync does not support.


How to resolve it:

  • Check the inventory location assigned to the affected product in Shopify.
  • If the product uses an unsupported fulfillment service location, exclude it from the sync if appropriate.
  • If you need help identifying the affected products, contact our support team.


3. Value does not exist in provided choices

A value in your feed does not match the allowed choices set for a Shopify metafield.


How to resolve it:

  1. Identify the metafield and the value causing the error.
  2. In your Shopify admin, go to Settings → Custom data.
  3. Select the relevant resource type and metafield definition.
  4. Under Validations, add the missing value to the list of allowed choices.
  5. Save your changes and run the feed again.


Stock Sync does not add missing values to Shopify metafield validations automatically. You must add them in Shopify.


4. Publication does not exist or is not publishable

Stock Sync tried to publish a product to a sales channel that does not support publishing it.


How to resolve it:

  • Check the affected product's publication settings in Shopify.
  • Make sure the relevant sales channels are available and support publishing the product.
  • Review the publication settings for any channels that cannot publish the product.


If a product cannot be published to one sales channel, it may still be published to other eligible channels. Only the affected channel may fail to update.


5. You need to add option values for Black

A variant value, such as Black, is missing from the feed data or does not match the variant options set up in Shopify.


How to resolve it:

  1. Check the feed data to confirm that the required variant value, such as Black, is included.
  2. If the value is missing, update your feed data to include the correct variant value.
  3. If you do not want to sync the affected product, exclude it from the sync.


Once the product is excluded, Stock Sync can continue processing the other products without this error.



Still Need Help?


If you cannot identify the cause of an error or cannot locate the affected products, contact our support team and share the downloaded Error List file.



Troubleshooting Steps

  • Issue: Products are not updated and the Error List shows NON_MUTABLE_INVENTORY_ITEM → Solution: Exclude the bundle product with the Store Product Filter, or delete and re-import it.
  • Issue: Products are not updated and the Error List shows ITEM_NOT_STOCKED_AT_LOCATION → Solution: Check the product's inventory location in Shopify and exclude products with unsupported fulfillment service locations.
  • Issue: Products are not updated and the Error List shows "Value does not exist in provided choices" → Solution: Add the missing value under Validations in Settings → Custom data in Shopify, then run the feed again.
  • Issue: Products are not updated and the Error List shows a publication error → Solution: Check the product's publication settings and the sales channels in Shopify.
  • Issue: Products are not updated and the Error List shows a missing option value, such as Black → Solution: Add the missing value to the feed data, or exclude the product from the sync.



Good Articles to Continue

Updated on: 13/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!