What information is required for my XML feeds to work properly?

For an XML feed to work properly in Stock Sync, the file must contain a valid parent node and product-level fields that can be mapped. Each feed must include actual product entries—if the file contains no products, or products cannot be detected, nothing will be updated.

When requesting feed setup or troubleshooting, provide a valid sample product that exists both in your store and in the supplier’s XML feed. Include the direct supplier product link and the corresponding store product link, along with the expected result. Samples that are not present in the store or feed cannot be used to verify matching or mapping.

Make sure the XML feed clearly includes the fields you want to sync, such as name, description, details, images, weight, stock, manufacturer, SKU, EAN, price, or compare-at price, so they can be mapped in Stock Sync. Also specify the product identifier to use for matching, such as SKU or barcode. XML field names are case-sensitive, so the mapped node must exactly match the source, such as id rather than ID.

If you want to import categories, they depend on the product’s title and description matching Shopify’s Standard Product Taxonomy. If the product content does not match that taxonomy, categories may not appear even if the XML contains them.

For products with variants, the feed must provide a value shared by all variants that can be used as the Variant Group, complete option values such as color or size, and a unique identifier such as SKU for every variant. Variant Group is available for Add feeds, not Update feeds. If the supplier XML has no node that can serve as a Variant Group, the variants cannot be combined into one Shopify product by this method.

If the feed includes multiple images, provide direct, publicly downloadable image URLs. Map all image sources and set the Image Column Separator to the delimiter used by the feed when several URLs are stored in one field. For repeated XML nodes such as multiple <image> elements under one product, map the repeated image values as an image list/array rather than mapping only the first node. If the parser does not expose the repeated nodes correctly, the feed mapping may require technical remapping. The first URL becomes the primary image.

If your supplier uses mixed decimal formats (comma and dot), ensure the price values are standardized. If needed, use Liquid mapping such as {{ data | jmespath: "RegularPrice" | gsub: ",", "." }} to convert commas to decimals for correct price import; the Price field does not have a built-in Find and Replace function.

Note: Stock Sync requires correct parent node and product identifier mapping. Incorrect mapping or filters that exclude required fields (such as filtering for EAN when no EAN exists) may result in zero products being imported.

Updated on: 07/08/2026