Skip to main content

Warning and Failed Statuses when Syncing a Product

What these statuses mean and how to resolve them

Written by Rayman

When you sync products to your Destination store, most will move to Synced. If a product didn't fully sync, it will show one of two statuses: Warning or Failed. Each one points to a different cause and a different fix.


How to find and read these statuses

When there are Warning or Failed products in your list, a banner appears at the top of the Products page, even if those products are not on the first page. You can also use the status filter to show only Warning or only Failed products.

To see why a specific product was flagged, hover over its status badge. The reason shows directly on the badge.


Failed


A Failed product means the product was not created in your Destination store, so there is nothing to fix on the product itself yet. You'll usually fix the cause on the Source store and sync again. A Failed product is not counted toward your synced product usage.

Common reasons shown on the badge:

- Duplicate SKU: Two or more variants share the same SKU. Make each SKU unique on the Source store, then sync again.

- Duplicate handle: A translated product on the Destination store is using the same URL handle. Rename the handle, then sync again.

- Shopify API error: Shopify couldn't process the request. Sync again to retry.

- Unknown error: Something went wrong on this product. If it keeps happening, check the help center or contact [email protected] with your store URL, product name and SKU.

To retry, use Sync on that product again, or Map if a matching product already exists on the Destination store.


Warning

A Warning product means the product was created, but some of its attributes did not fully come across. This usually involves inventory, images, or metafields.

To resolve it:

- Resync the product. Syncio re-checks the attributes and tries again. If it succeeds, the product moves to Synced.

- If it stays in Warning, use Unsync & Delete to remove the product, then Sync it again. Unsync & Delete asks you to confirm before it runs.


Other causes to check

Some causes don't have their own reason on the badge:

- Backslash (\) in a SKU: Shopify allows this character in the admin but blocks it when an app creates the variant, so the product can't be created. Change the SKU on the Source store to use only letters, numbers, dashes or underscores, then sync again.

- Your store has over 50,000 variants: Shopify then limits new variant creation to 1,000 every 24 hours, so some products won't come across until Shopify allows more. Sync them again later.

- A product with a lot of images: Shopify can block the import, or the product comes across without all its images (Warning). Try Sync or Resync again. If it still doesn't work, the Source store can export the product with Shopify's CSV export, you import the CSV into your store, then use Map to link it.


After fixing a SKU issue

If the cause was a duplicate or mismatched SKU, related entries can stay in your Activity Center after the product syncs. Once the product is confirmed synced, you can dismiss those entries. For a step by step on SKU mismatches, see Repairing a Sync due to a SKU Mismatch and Missing SKU.

Did this answer your question?