Connect Shopify to Rig with your own app

    Create a private Shopify app owned by your organisation, install it on your store, then give Rig its Client ID and Client Secret. This connects Shopify without waiting for Rig's shared public app to pass App Store review. Rig uses read-only access and requests a fresh short-lived token for every sync.

    Seeing “This app is under review”?
    Cancel that installation. It is the shared Rig app, which Shopify will not let a new merchant install until its review is complete. Follow this guide to create an app inside your own Shopify organisation instead.

    Why use your own app

    Shopify's client credentials flow is designed for trusted server-to-server integrations that are owned by the same organisation as the store. Because you own both the app and the store, the app does not need an App Store listing or public-app review. It can only be installed on stores in your Shopify organisation.

    Shopify access is still controlled by the read scopes you grant. Your Shopify plan and protected-customer-data settings can also affect whether customer names, emails, phone numbers and addresses are returned.

    Before you start

    • Sign in with the Shopify organisation that owns the store you want to connect. The app and store must belong to the same organisation.
    • You need permission to build and manage apps. The organisation owner has this automatically; another user needs the relevant app development role or permission.
    • Know the permanent .myshopify.com address of the store. Your customer-facing domain is not the value Rig needs.
    • By the end, you will paste three values into Rig: the shop subdomain, Client ID and Client Secret.

    Step 1: Create the Shopify app

    1. Open Shopify's Dev Dashboard and make sure the correct organisation is selected.
    2. Open Apps, then click Create app.
    3. Choose Start from Dev Dashboard.
    4. Name the app Rig data sync and click Create.

    Step 2: Configure read access

    1. Open the app's Versions tab and create a version.
    2. For the app URL, use Shopify's default non-embedded app URL, https://shopify.dev/apps/default-app-home. Rig does not need an app screen inside Shopify.
    3. Choose the newest available Webhooks API version.
    4. Add the Admin API access scopes. The field takes a comma-separated list, so paste this exactly:
      read_orders,read_customers,read_products,read_locations,read_inventory,read_discounts
      Grant all six for the complete sync. Rig shows streams as unavailable when the installed app is missing their read scopes.
    5. Release the version.

    Read-only by design
    Do not add write scopes. Rig only needs to read Shopify data for the warehouse sync.

    Need orders older than 60 days?
    Shopify documents read_orders as covering the latest 60 days by default. For a full historical backfill, request access to read_all_orders in the app's API access area, then add it alongside read_orders in a new released version. Shopify may review this restricted scope.

    Step 3: Install the app on your store

    1. Open the app's Home tab in the Dev Dashboard.
    2. Scroll to the installation section and click Install app.
    3. Select the store you want Rig to sync.
    4. Review the read permissions and click Install.

    If your store is not listed, it is usually in a different Shopify organisation. Switch to the organisation that owns the store and create the app there.

    Step 4: Copy the credentials

    1. In the app, open Settings.
    2. Under Credentials, copy the Client ID.
    3. Reveal and copy the Client Secret. Treat it like a password.
    4. Find your store's permanent address, for example acme.myshopify.com. Rig needs only the part before the suffix, in this example acme.

    There is no token to copy
    That is expected for a Dev Dashboard app using client credentials. Rig exchanges the Client ID and Client Secret for a Shopify access token when each sync starts. The token expires after about 24 hours, so there is nothing for you to refresh manually.

    Step 5: Connect it in Rig

    Adding a source needs a workspace owner, or a role with the Manage connections permission, on a workspace where you manage your own connections. If the Connectors tab says “Data ingestion for this workspace is managed by Rig”, ask an owner or Rig support to add the source.

    1. In Rig, open Connections, choose the Connectors tab and go to Sources & actions.
    2. Search for Shopify, open the card and click Connect.
    3. In Shop subdomain, enter only the part before .myshopify.com.
    4. Leave Option A — Admin API token (optional) blank. That field is only for older Shopify custom apps that already have a permanent token.
    5. Paste the Shopify Client ID into Option B — App API key / client ID (optional).
    6. Paste the Shopify Client Secret into Option B — App API secret / client secret (optional).
    7. Leave Days of history on first sync (optional) at 0 for all history Shopify permits, or enter a smaller number for a faster first sync.
    8. Click Continue, which uses the app you created. The Authorize with Shopify button beside it opens the shared Rig app, which you do not want here. Rig checks the credentials and lists the streams it can reach, so choose the ones you want and click Connect.
    9. The source then syncs on its schedule, which is nightly unless you change it. To load data straight away, click Sync on its row; Test pulls a small sample first if you want to check the connection.

    What Rig pulls in

    Shopify lands in its own dataset or schema in your warehouse, named for the connection (typically shopify). Rig uses Shopify's GraphQL Bulk Operations API for the large tables, then keeps them current with incremental syncs.

    • Orders, line items, transactions, refunds, fulfilments, shipping lines, tax lines and discount applications
    • Customers and their order history, subject to Shopify's protected-customer-data rules
    • Products, variants, options and collections
    • Locations and inventory levels
    • Discounts and refund detail

    Troubleshooting

    • “This app is under review”: you opened the shared public Rig app. Cancel and use the merchant-owned app flow in this guide.
    • The store is missing at install: the app and store are not in the same Shopify organisation, or your user lacks access to the store.
    • Rig reports invalid client credentials: copy the Client ID and Secret again from the app's Settings page, and check that the app is installed on the exact store subdomain entered in Rig.
    • A stream is unavailable or sync reports access denied: check that its read scope is in the released app version and granted to the installed app. After changing scopes, update or reinstall the app as Shopify instructs. For an in-progress connection, click Continue again; for an existing source, click Sync on its row. With Option B, keep the Client ID and Secret in Rig: Rig requests a new access token when it syncs, so there is no token to copy or paste. Only a connection made with an Option A Admin API token needs a new shpat_ token pasted into Rig.
    • Only recent orders appear: request and release read_all_orders, or confirm with Shopify what historical access the app has.
    • You rotated the Client Secret: update the secret in Rig before the next sync. The old secret stops working after you revoke it.

    What people use this for

    • Track revenue, AOV and discount impact
    • Measure repeat purchase, LTV and cohorts
    • Analyse product and inventory performance
    • Understand contribution margin per order

    More ideas for using Shopify

    Was this guide helpful?