Connecting Your Shopify Store
~4 min readWhen you install dashboardSMASHBOARD, you go through Shopify's standard OAuth flow. This page explains what's happening, what data we access, and how to re-authorise if something breaks.
How the Connection Works
dashboardSMASHBOARD uses Shopify's official Partner API to read your store data. When you click Install app, Shopify generates a secure access token and passes it to us. We store it encrypted and use it to pull data on a regular schedule.
We never see your Shopify admin password. We can't write to your store — all our access is read-only.
What We Access
| Data type | Why we need it |
|---|---|
| Orders | Revenue, conversion, and fulfilment metrics in your smashes |
| Products | Product-level sales breakdowns and inventory goals |
| Customers | Customer acquisition and retention goal tracking |
We do not request write access, payment details, or staff account information.
Data Sync Frequency
Your Shopify data syncs automatically every 15 minutes. Dashboards reflect data up to 15 minutes old by default. Historical data from before installation is pulled on a one-time backfill (up to 12 months).
Revoking or Re-authorising Access
To disconnect dashboardSMASHBOARD from your store, uninstall the app from Shopify Admin → Apps → dashboardSMASHBOARD → Delete. This immediately revokes our access token.
If you need to re-authorise (for example, after a store migration), uninstall and reinstall the app. Your dashboards and smash configurations are preserved in your dashboardSMASHBOARD account.
Troubleshooting Connection Issues
Data stopped updating
If your smashes show stale data, the most common cause is a revoked or expired token. Head to dashboardSMASHBOARD settings and click Reconnect Shopify to re-authorise.
Permission error on install
Your Shopify staff account needs the Manage and install apps and channels permission. Ask the store owner to enable it under Settings → Users and permissions.
Store not appearing in the list
Make sure you're logged in to the correct Shopify account. If you manage multiple stores, check you're installing to the right one.
Still need help?