Each connected store shows its sync status and the time of its last successful sync, in the web app and in the add-in. Most statuses clear on their own. The ones that need you say what to fix.
Where to see sync status
Data Connectors: Each store's status, last sync time, and history start date, with Sync now or Retry sync next to it.
Overview: An alert when a store's sync fails, with a link to Data Connectors.
Add-in header: A line showing when your data last synced, such as "Shopify synced 2h ago."
Data Sources panel: Each store's status in the add-in, with Pull latest raw data to start a sync.
Statuses that clear on their own
Status | What it means |
Not synced yet | The store is connected, and its first sync hasn't started. |
Setting up sync | Merchant Sheets is preparing the connection. This happens once, on the first sync. |
Syncing | Your Shopify data is being copied. |
Finishing up | Personal data is being removed and your data organized. Usually a minute or two. |
Waiting to finish processing | Finishing up is taking longer than usual. It completes on its own. |
Waiting to retry: the database was busy | The sync paused for a moment and retries automatically. |
Retrying | Merchant Sheets started the sync again after a pause. |
Up to date | The last sync finished, and your data is ready. |
Statuses that need you
Status | What to do |
Shopify rejected the keys | Shopify refused your Client ID or Client secret. Check that the app is released and installed on the store, then update your credentials. |
Missing permissions | The app is missing scopes. Add the ones listed, release a new version, install the app again, then select Retry sync. Shopify permissions we ask for, and why lists every scope. |
Sync service unavailable | A temporary problem on our side or Shopify's. Wait a few minutes and select Retry sync, or let the next scheduled sync run. |
Last sync failed | Select Retry sync. If it fails again, contact support with your store URL and the time it failed. |
If your data looks out of date
Check the store's last sync time first. If the sync ran after the change you're looking for, the data is in Merchant Sheets, and you need to refresh your sheet. If it hasn't synced since, select Sync now or wait for the next scheduled sync. Sync schedule by plan shows how often that is.