Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.spotzee.com/llms.txt

Use this file to discover all available pages before exploring further.

The Store Details drawer is the at-a-glance health view for a connected Shopify store. Open it from the store card menu. Three sections: store information, granted permissions, and the readiness checklist.

​
Open store details

1

Open Integrations

Inside the project, open Integrations.
2

Open the store details

Find the store card and use the card menu to pick View details.

​
Store information

FieldWhat it shows
Store domainThe <store>.myshopify.com domain
EmailThe store’s contact email from Shopify
Custom domainYour store’s primary custom domain if configured
PlanThe Shopify plan tier the store is on
CurrencyDefault currency for the store
CountryWhere the store is registered
CreatedWhen the Spotzee integration was first connected
This information mirrors what Spotzee learned from the OAuth handshake plus the initial Shopify API call. It refreshes on every health check.

​
Granted scopes

The drawer lists every OAuth scope Spotzee currently holds for the store. Each scope is one permission Shopify granted at install. Common scopes:
  • read_customers, write_customers
  • read_orders, write_orders
  • read_products
  • read_inventory (for inventory-aware personalisation, when used)
If you don’t see a scope you expected, the install on Shopify didn’t grant it. Reconnect to re-approve and pick up the missing scope.

​
Store readiness checklist

The Store Readiness section is the integration’s health checklist. Five items, each pass or fail:
CheckVerifies
OAuth connectedThe OAuth grant is live and Shopify recognises the app
Token validThe access token hasn’t expired
All scopes grantedEvery scope the integration needs is approved
API respondingA test API call to Shopify returns a successful response
Initial sync completeAt least one full sync has finished successfully
A healthy integration has all five items checked. Any failure flips the integration’s status badge to Error and points you at what to fix.

​
Last checked timestamp

The drawer shows when the readiness checklist last refreshed. Run a manual health check (see Sync operations) to refresh it on demand.

​
What each failure means

Failed checkLikely causeFix
OAuth connectedApp was uninstalled in Shopify, or the merchant revoked accessReconnect from the store card
Token validAccess token expired (rare on long-lived integrations)Reconnect
All scopes grantedScopes changed or were trimmed during a re-installReconnect to re-approve full scope set
API respondingShopify API outage or rate-limit hitWait a few minutes, then run a fresh health check
Initial sync completeInitial sync failed or was never runOpen sync settings and run the initial sync

​
Next steps

Sync operations

Run health checks and read sync statuses.

Disconnect, delete, reconnect

What each action does and when to use which.

Troubleshoot

Diagnose connection and sync failures.

Sync settings

Configure toggles and the customer list.