Warning and Failed Statuses when Syncing a Product

What these statuses mean and how to resolve them

Written by Rayman
Updated over 3 weeks ago

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 support@syncio.co 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.

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.