Connect Shopify
Authorize a Shopify store by domain and understand Runner's disconnect behavior.
Connect Shopify when your storefront or Runner workflow needs access to an existing
Shopify store. Runner starts authorization from the store's myshopify.com domain and
Shopify asks you to install and authorize the Runner app.
Before you start
Entry path: Project → Apps → Store Apps → Shopify
You can also choose Connect Shopify when creating a store from the workspace. This guide focuses on the connection card under Apps.
You need:
- Shopify integration availability in the workspace;
- a Shopify store domain in the form
your-store.myshopify.com; - permission to install and authorize the Runner app in that Shopify store; and
- authority to connect the store to the Runner workspace.
A workspace that already has a connected Shopify store can require you to disconnect it before connecting another one.
Shopify controls and results
| Control | Why it is useful | What happens next |
|---|---|---|
| Connect | Opens Shopify setup. | Runner asks for Shop domain. |
| Shop domain | Identifies the exact Shopify store. | Runner accepts the your-store.myshopify.com format and shows an error for an invalid domain. |
| Continue to Shopify | Starts provider authorization. | Runner redirects to Shopify to install the Runner app and authorize access. |
| Cancel or close | Stops before authorization. | Runner closes the dialog and clears the entered domain. |
| Connecting... | Shows that the authorization redirect is starting. | The action remains unavailable while Runner leaves for Shopify. |
| Delete or Disconnect | Starts removal. | Runner opens Disconnect Shopify?. |
| Confirmation Disconnect | Removes Runner's Shopify connection. | Runner removes the Shopify storefront token from all workspace projects. The Shopify store and its orders are not deleted. |
Connect Shopify
- Open Project → Apps and find Shopify.
- Select Connect.
- Enter the store's exact
myshopify.comdomain in Shop domain. - Correct any invalid-domain message before continuing.
- Select Continue to Shopify.
- On Shopify, verify the store name and requested access before authorizing the Runner app.
- Return to Runner and confirm the Shopify card shows its connected disconnect control.
- Verify the intended store data and checkout path before making live changes.
Disconnect or change stores
Select the disconnect control and read Disconnect Shopify?. Confirming removes the Shopify storefront token from all projects in the workspace. It does not delete the Shopify store or existing Shopify orders.
To connect a different Shopify store, disconnect the existing workspace connection first, confirm the card is no longer connected, then repeat setup with the other store's domain.
If Shopify does not connect
- Use the permanent
myshopify.comdomain, not a custom storefront domain. - If Runner says the workspace already has a connected store, review that connection before removing it.
- If Shopify rejects authorization, start again from the Shopify card.
- If the returned store does not match the domain you entered, stop and verify which Shopify account and store are open.
- If the connection link expired, start over from Connect rather than reusing the old provider page.
- If Runner reports that required access is missing, review the app permissions in Shopify.
- If disconnecting fails, assume the existing connection is still active.