Before you start#

The Shopify sync is one-way, from GemIQ to Shopify. You can run it yourself with Sync Now, or set a schedule using the dropdown next to it.

image.png

A scheduled sync follows the same rules as a manual one: products that are Active in Shopify are not updated. Make sure you have a stable internet connection, and keep the app open until a manual sync finishes.

Find out what didn’t sync#

Go to Integrations and open Shopify. In Recent syncs, each row shows the total, successful and failed product counts for one sync. Click See Details on the sync that failed.

image.png

The What did not sync panel groups failed products by reason and lists each product by name and SKU. Select a reason on the left to see what it means. Where the fix is in Shopify, click Open Shopify to go straight there.

image.png

Fix the problem that matches what you see#

Products show as synced, but images, descriptions or media changes don’t appear in Shopify.

GemIQ does not overwrite products that are Active (live) in Shopify. In Shopify, set the product to Draft, check that its SKU exactly matches the SKU in GemIQ, and run the sync again. Then refresh the product page in Shopify. Also check your sync settings: any attribute that isn’t selected, such as Media or Description, is not sent to Shopify.

The sync creates a blank or duplicate draft.

When GemIQ can’t find a Shopify product with a matching SKU, it creates a new product in Draft status instead of updating the existing one. Check that the SKU matches exactly and that the product has images in GemIQ before syncing. If the draft is still blank, contact support with the SKU.

The Sync Now button flashes but nothing happens, or Sync all products does nothing.

Try syncing a smaller set of products using a collection:

  1. On the Sync products to Shopify card, select Sync another collection.

  2. Choose a collection from the list. To make a new one, click Create collection.

image.png

Click Sync Now.

image.png

If the sync was interrupted

  • This can happen due to a lost internet connection or if the app or browser was closed prematurely. Ensure your connection is stable and restart the sync, allowing it to complete fully without closing the app.

If the button still doesn’t respond, disconnect Shopify from Integrations, reconnect it, and try again.

Common Issues#

Shopify billing issue A billing problem on your Shopify account is blocking the sync. Click Open Shopify, resolve the billing issue in your Shopify account, then sync again.

Media resource limit has been reached. Shopify limits how many images and videos a single product can hold depending on the plan a user is on. Review your plan on Shopify to continue syncing.

The sync stopped partway. A lost connection or closing the app can interrupt a sync. Reconnect to a stable network and sync again, keeping the app open until it finishes.

Choosing which products to sync
On the Sync products to Shopify card, you can sync all products, a collection of your choice, or the Sent to Shopify collection. Sent to Shopify is a manual collection, so it only contains the products you add to it in Collections. Click Open collection to view it.

image.png

Step 3: If it still doesn’t work#

Disconnect and reconnect Shopify in Integrations, then try again. If the sync still fails, contact support@gemiq.com. Include your GemIQ email address, the affected SKUs, and a screenshot of the What did not sync panel.

Expected Result#

After identifying and resolving the specific error, you should be able to restart the sync, and it will complete successfully, adding your product media to your Shopify store.

Common Questions#

Q: Why isn’t my GemIQ App syncing to Shopify?#

A: Most often the product is Active in Shopify or its SKU doesn’t match GemIQ exactly. Set it to Draft, check the SKU, and sync again.

Q: Does the Shopify sync run automatically?
A: Only if you set a schedule. Choose every hour, every 3, 6 or 12 hours, or once a day from the dropdown next to Sync Now. By default it’s set to off.

Q: Can I sync only some products?
A: Yes. Select Sync another collection and choose the collection from the list, or add products to the Sent to Shopify collection and sync that.

Q: Why didn’t my price or quantity change in Shopify?
A: Only the details ticked in What we send to Shopify are sent. Tick Price or Quantity, check the product is in Draft status in Shopify, and sync again.

Q: Do 360° videos sync to Shopify?
A: Yes, but Shopify has no 360° video format, so they appear in Shopify as ordinary videos.

image.png