Skip to content

Integrations

Connect Shopify

Connect your own Shopify store to follow order value, orders, and average order value.

On this page

Before you start

You need permission to create and install an app in Shopify. The app and store must belong to the same Shopify organization. This setup is for your own store; it is not a Shopify App Store installation.

Create and install an app

  1. Open the Shopify Dev Dashboard and select the organization that owns your store.
  2. Create an app named Dockset. In its version configuration, grant read_orders access. No write scopes are needed.
  3. Release the version and install the app on the store you want to connect.
  4. Open the app’s Settings and copy its Client ID and Client secret.

Shopify documents creating an app in the Dev Dashboard and connecting stores in your organization.

Connect in Dockset

  1. Add Shopify from Add Widget → Business and open the widget.
  2. Enter the store’s your-store.myshopify.com domain. Use its Shopify domain, not your storefront’s custom domain.
  3. Enter the Client ID and Client secret, then choose Connect. Dockset handles access tokens for you.
  4. Choose the store, metric, period, and chart display.

What the numbers mean

  • Order value: current order totals after returns and discounts, including tax and shipping. Includes unpaid orders; excludes test and cancelled orders.
  • Orders: the count of those orders, including fully returned orders.
  • Average order value: order value divided by orders. With no orders, it shows an unavailable value.

These are order totals, not cash received or Shopify Analytics sales. Refunds and edits change the original order’s day. Periods use your store’s time zone and currency: Today, Last 7 days, Month to date, and Last 30 days.

If the connection fails

  • Permission error: check that the installed version includes read_orders. Changing a draft without releasing it does not update the installed app.
  • Credentials rejected: verify the Client ID, Client secret, store domain, and that the app is installed on a store in the same organization.
  • Different totals: compare the definitions above, the store’s time zone, and your selected period. Unpaid orders and tax can explain differences from sales reports.
  • Report too large: Dockset cannot display a complete report above its 10,000-order limit. It shows an error rather than a partial total.

Refresh and disconnect

The widget refreshes every five minutes while active, with a manual Refresh action. Credentials stay in macOS Keychain. Disconnect removes them locally; revoke the app’s access in Shopify to remove its access there too.