Shopify: Authentication Troubleshooting

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 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.
   
   
3. Once in the App Development section, click on Build Apps in Dev Dashboard button.
   
   

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.

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.

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.
   
   
2. Copy the URL detailed below and paste it in the URLs box:
   
   - https://query-manager.dataslayer.ai/shopify/init
   
   
    
   Make sure “Embed app in Shopify Admin” is NOT enabled:
    
   
   
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
   
   
   
   
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.
      
      
   2. On the next site, in the section Read all orders scope, click the Request access button.
      
      
   3. You will be asked to provide a justification.For example: “60 days are not useful for analytics.”
   4. Once submitted, the request status should show a message such as Your app can access the full order history for a store.

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.
   
   
   
   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.
   
   
   
   

Step 6: Release the App Version

Once permissions are configured:

1. Click Release at the top of the page.
2. In the pop-up window that will appear, you can leave the fields blank or provide a version name. Then, click on Release.
   
   

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 Hub section in Dataslayer and look for Shopify data source
  
  
  
  
• Locate the field Custom Install URL
  
  
  

Then:

1. Copy the install URL from the Installs section in your Shopify Developer Dashboard (use the copy button)
   
   
   
   
2. Paste it into the Custom Install URL field in Dataslayer
   
   
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.
     
     
     
4. Click Connect
   
   
5. You will be redirected to the Shopify login page:
   
   • Select your store
   • Install the app
     
     
     
     

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.
  

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.

As always, please do not hesitate to contact us via our live chat on our website or via e-mail if you still have doubts or questions. We are happy to help!