---
title: "Shopify: Authentication Troubleshooting"
description: Learn how to connect Shopify to Dataslayer when the Distribution Method option is missing or an Internal Server Error occurs during authentication.
---

[Skip to content](https://support.dataslayer.ai/shopify-authentication-troubleshooting#main-content)

- [English](https://support.dataslayer.ai/shopify-authentication-troubleshooting)
- [Español](https://support.dataslayer.ai/es/shopify-authentication-troubleshooting)

English

Show submenu for translations

[![Dataslayer](https://support.dataslayer.ai/hs-fs/hubfs/Dataslayer_New_Logo.png?height=35&name=Dataslayer_New_Logo.png)](https://www.dataslayer.ai/)

Open main navigation

Close main navigation

- - [English](https://support.dataslayer.ai/shopify-authentication-troubleshooting)
    - [Español](https://support.dataslayer.ai/es/shopify-authentication-troubleshooting)

  English
  
  Show submenu for translations

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Knowledge base](https://support.dataslayer.ai/?hsLang=en)
2. [Data Sources](https://support.dataslayer.ai/data-sources?hsLang=en)

July 15, 2026

# Shopify: Authentication Troubleshooting

## In this article, we explain how to connect Shopify to Dataslayer when the Distribution Method option is missing or an Internal Server Error occurs during authentication.

This troubleshooting guide explains how to complete the Shopify connection to Dataslayer when the **Distribution Method** option is unavailable or an **Internal Server Error** appears during authentication.

Follow the steps below to configure the app correctly and establish a stable connection. 

#### **Issue 1: Does the Distribution Method button not appear?**

If you do not see the **Distribution Method** option in the Shopify Developer Dashboard, follow this alternative setup process:

##### **Step 1: Access the Shopify Developer Dashboard**

1. Go to [https://accounts.shopify.com/store-login](https://accounts.shopify.com/store-login) and proceed with your login.
2. In the navigation menu, locate and click on the section **App and sales channel settings**. Then, click the **Develop App** button.
   
   ![](https://support.dataslayer.ai/hs-fs/hubfs/A%20-%20Shopify%20Auth%20Guide/1.png?width=644&height=250&name=1.png)
3. Once in the App Development section, click on **Build Apps in Dev Dashboard** button.
   
   ![](https://support.dataslayer.ai/hs-fs/hubfs/A%20-%20Shopify%20Auth%20Guide/2.png?width=670&height=261&name=2.png)

##### **Step 2: Create a New App**

By default, you will see a list of your current apps. To create a new one, click **Create app**.

![](https://support.dataslayer.ai/hs-fs/hubfs/A%20-%20Shopify%20Auth%20Guide/3.png?width=670&height=261&name=3.png)

##### **Step 3: Define the App Name**

Enter a name for your app. This name is internal and can be anything that helps you identify the integration.

![](https://support.dataslayer.ai/hs-fs/hubfs/A%20-%20Shopify%20Auth%20Guide/4.png?width=670&height=261&name=4.png)

##### **Step 4: Create a New App Version to request permissions**

1. Back in the **DEV Dashboard**, go to **Versions** in the left-hand menu and then click on **Create a version** for the app.
   
   ![](https://support.dataslayer.ai/hs-fs/hubfs/A%20-%20Shopify%20Auth%20Guide/Shopify%20Log%20In%20(1).png?width=670&height=261&name=Shopify%20Log%20In%20(1).png)
2. Copy the URL detailed below and paste it in the **URLs** box:
   
   \- https://query-manager.dataslayer.ai/shopify/init
   
   ![](https://support.dataslayer.ai/hs-fs/hubfs/Shopify%20Log%20In.png?width=670&height=261&name=Shopify%20Log%20In.png)  
      
   Make sure **“Embed app in Shopify Admin” is NOT enabled**:  
    **![](https://support.dataslayer.ai/hs-fs/hubfs/Shopify%20Log%20In%20(1)-1.png?width=670&height=261&name=Shopify%20Log%20In%20(1)-1.png)**
3. Scroll down and copy the 2 URLs below and paste them where it says **Redirect URLs:**
   
   https://query-manager.dataslayer.ai/shopify/save\_token, https://query-manager.dataslayer.ai/shopify/save\_token\_subscriptions  
   ![](https://support.dataslayer.ai/hs-fs/hubfs/Shopify%20Log%20In%20(1).png?width=670&height=261&name=Shopify%20Log%20In%20(1).png)
4. Now, we will need to **Request Access to All Orders**. Most clients require **at least 1 year of historical data**, so this step is strongly recommended. 
   
   If the *Request Access* button does not appear, you can move into the step 5 directly.  
     1. Go to the **Access** section and click **“Request access”** at the description.
        
        ![](https://support.dataslayer.ai/hs-fs/hubfs/A%20-%20Shopify%20Auth%20Guide/11.png?width=670&height=261&name=11.png)
     2. On the next site, in the section **Read all orders scope**, click the **Request access** button.
        
        ![](https://support.dataslayer.ai/hs-fs/hubfs/A%20-%20Shopify%20Auth%20Guide/12.png?width=584&height=227&name=12.png)
     3. You will be asked to provide a justification.For example: *“60 days are not useful for analytics.”![](https://support.dataslayer.ai/hs-fs/hubfs/A%20-%20Shopify%20Auth%20Guide/13.png?width=670&height=261&name=13.png)*
     4. Once submitted, the request status should show a message such as *Your app can access the full order history for a store*.![](https://support.dataslayer.ai/hs-fs/hubfs/A%20-%20Shopify%20Auth%20Guide/14.png?width=670&height=261&name=14.png)

If this step is skipped, **Shopify limits order data access to only the last 60 days**, which is not sufficient for most analytics use cases.

**Important**

After requesting this permission, **reload the Developer Dashboard page**.  
Otherwise, the ***read\_all\_orders* scope will not appear in the permissions list**.

##### **Step 5: Configure Permissions (Scopes)**

1. Now, back in the refreshed Dev Dashboard page, you can define the required scopes by navigating to the **Access section** and clicking on **Select Scopes**.
   
   ![](https://support.dataslayer.ai/hs-fs/hubfs/A%20-%20Shopify%20Auth%20Guide/15.png?width=670&height=261&name=15.png)
   
   These are the permissions needed for full analytics and data extraction: 
     1. **read\_analytics**
     2. **read\_customers**
     3. **read\_fulfillments**
     4. **read\_inventory**
     5. **read\_orders**
     6. **read\_products** (Required to retrieve product information)
     7. **read\_all\_orders** (Only visible after requesting access in the previous step)
     8. **read\_marketing\_events** (Required for the Marketing Events category)
2. Once selected, all the scopes mentioned, click on **Done**.
   
   ![](https://support.dataslayer.ai/hs-fs/hubfs/A%20-%20Shopify%20Auth%20Guide/16.png?width=670&height=261&name=16.png)
   
   ![](https://support.dataslayer.ai/hs-fs/hubfs/A%20-%20Shopify%20Auth%20Guide/17.png?width=670&height=261&name=17.png)

##### **Step 6: Release the App Version**

Once permissions are configured:

1. Click **Release** at the top of the page.![](https://support.dataslayer.ai/hs-fs/hubfs/A%20-%20Shopify%20Auth%20Guide/19.png?width=670&height=261&name=19.png)
2. In the pop-up window that will appear, you can leave the fields blank or provide a version name. Then, click on **Release**.
   
   ![](https://support.dataslayer.ai/hs-fs/hubfs/A%20-%20Shopify%20Auth%20Guide/20.png?width=670&height=261&name=20.png)

##### **Step 7: Use Custom Install URL via Dataslayer**

After creating and releasing the app version:

- **Do NOT install the app from Shopify yet**
- Go to the **<https://support.dataslayer.ai/about-the-dataslayer-hub?hsLang=en>[Hub section](https://support.dataslayer.ai/about-the-dataslayer-hub?hsLang=en) in Dataslayer** and look for **Shopify** data source
  
  ![NEW UI 2025 - About the Hub ](https://support.dataslayer.ai/hs-fs/hubfs/NEW%20UI%202025%20-%20About%20the%20Hub%20.png?width=670&height=368&name=NEW%20UI%202025%20-%20About%20the%20Hub%20.png)
- Locate the field **Custom Install URL
  
  ![39](https://support.dataslayer.ai/hs-fs/hubfs/39.png?width=670&height=261&name=39.png)**

Then:

1. Copy the install URL from the **Installs section** in your Shopify Developer Dashboard (use the copy button)
   
   ![Shopify Log In (3)](https://support.dataslayer.ai/hs-fs/hubfs/Shopify%20Log%20In%20(3).png?width=670&height=261&name=Shopify%20Log%20In%20(3).png)
2. Paste it into the **Custom Install URL** field in Dataslayer
   
   ![40-1](https://support.dataslayer.ai/hs-fs/hubfs/40-1.png?width=644&height=250&name=40-1.png)
3. Fill in: 
     - **Shop Name** (only the store name, without *https://* and *.myshopify.com*)
     - **Client ID** and **Client Secret**  
       This information is displayed in the *Settings section* in the Dev Dashboard.
       
       **![Shopify Log In (2)](https://support.dataslayer.ai/hs-fs/hubfs/A%20-%20Shopify%20Auth%20Guide/Shopify%20Log%20In%20(2).png?width=670&height=261&name=Shopify%20Log%20In%20(2).png)**
4. Click **Connect
   
   ![41-1](https://support.dataslayer.ai/hs-fs/hubfs/41-1.png?width=670&height=261&name=41-1.png)**
5. You will be redirected to the Shopify login page:  
     - Select your store
     - **Install the app**
       
       ![32](https://support.dataslayer.ai/hs-fs/hubfs/32.png?width=670&height=261&name=32.png)

**Done!** Once installed, the connection will appear in the Hub.

#### **Issue 2: Internal Server Error during connection**

If you encounter an **Internal Server Error**, verify the following:

- **App URL and Redirect URLs are correctly configured**  
  Ensure they exactly match: 
    - App URL:  
      https://query-manager.dataslayer.ai/shopify/init
    - Redirect URLs:   
      https://query-manager.dataslayer.ai/shopify/save\_toke, https://query-manager.dataslayer.ai/shopify/save\_token\_subscriptions
- **“Embed app in Shopify Admin” is NOT enabled**  
  This setting can break the authentication flow
- **Use the original store name (important)**  
  Using the updated or display name may cause authentication errors. This applies specifically to the **Shop Name** field.
  
  Make sure you enter the **original Shopify store name**, not a renamed or updated version.

**Example**

If the store was originally created as *yourstorename* and later renamed to *yourstore*, you must enter: *yourstorename.*

**Do NOT use these formats for the Shop Name**

- *https://yourstorename.myshopify.com*
- *yourstorename.myshopify.com*

This completes the Shopify authentication setup. By following each step carefully and verifying that all fields are correctly configured, you should be able to establish a stable connection between Shopify and Dataslayer.

**If you want to pull data for multiple Shopify stores, you will need to repeat the authentication process for each one.**

As always, please do not hesitate to contact us via our live chat on [our website](https://dataslayer.ai/?__hstc=205882892.6526bb15cfac7d661ffbfd3c4281267e.1709723421854.1709899115717.1710148803745.8&__hssc=205882892.2.1710148803745&__hsfp=1885414922) or via [e-mail](mailto:info@dataslayer.ai) if you still have doubts or questions. We are happy to help!

- [General](https://support.dataslayer.ai/general?hsLang=en)
- [Billing & Pricing](https://support.dataslayer.ai/billing-pricing?hsLang=en)
- [Data Sources](https://support.dataslayer.ai/data-sources?hsLang=en)
- [Blended Connectors](https://support.dataslayer.ai/blended-connectors?hsLang=en)
- [Google Sheets](https://support.dataslayer.ai/google-sheets?hsLang=en)
- [Microsoft Excel](https://support.dataslayer.ai/microsoft-excel?hsLang=en)
- [Spreadsheets](https://support.dataslayer.ai/spreadsheets?hsLang=en)
- [Looker Studio](https://support.dataslayer.ai/looker-studio?hsLang=en)
- [Big Query](https://support.dataslayer.ai/big-query?hsLang=en)
- [API Query Manager](https://support.dataslayer.ai/api-query-manager?hsLang=en)
- [Power BI](https://support.dataslayer.ai/power-bi?hsLang=en)
- [Amazon S3](https://support.dataslayer.ai/amazon-s3?hsLang=en)
- [Amazon Redshift](https://support.dataslayer.ai/amazon-redshift?hsLang=en)
- [Snowflake](https://support.dataslayer.ai/snowflake?hsLang=en#main-content)

    - [Marketplace](https://support.dataslayer.ai/snowflake?hsLang=en#marketplace)
- [Google Cloud Storage](https://support.dataslayer.ai/google-cloud-storage?hsLang=en)
- [Database](https://support.dataslayer.ai/database?hsLang=en)
- [Azure SQL](https://support.dataslayer.ai/azure-sql?hsLang=en)
- [Azure Storage](https://support.dataslayer.ai/azure-storage?hsLang=en)
- [Dataslayer Atlas](https://support.dataslayer.ai/dataslayer-atlas?hsLang=en)
- [Morpheus](https://support.dataslayer.ai/morpheus?hsLang=en)
- [AI Looker Studio Analyzer](https://support.dataslayer.ai/ai-looker-studio-analyzer?hsLang=en)
- [Dataslayer MCP](https://support.dataslayer.ai/dataslayer-mcp?hsLang=en)
- [Dataslayer GPT](https://support.dataslayer.ai/dataslayer-gpt?hsLang=en)
- [Dataslayer AI Chat](https://support.dataslayer.ai/dataslayer-ai-chat?hsLang=en)

[![Chill listening crop-3](https://support.dataslayer.ai/hs-fs/hubfs/Dataslayer_New_Logo.png?width=142&height=24&name=Dataslayer_New_Logo.png "Chill listening crop-3")](https://dataslayer.ai/)

Dataslayer.ai: Digital Marketing Reporting Made Easy

<https://www.linkedin.com/company/dataslayer/> <https://www.youtube.com/@dataslayers>

Copyright © 2026, DATASLAYER SL