To access Connections: click your team name at the bottom left of your screen, select Settings, then click Connections in the left sidebar.
Before You Start
You'll need the Apps Developer role on your Shopify store to complete this setup. If you're the store owner, you already have access. If you're a staff member, ask your store owner to assign you the Apps Developer role in Shopify under Settings β Users and permissions.
Step 1: Create a Shopify Custom App
Go to the Shopify Dev Dashboard and sign in with your Shopify account
From the Apps tab, select "Create app" in the top right
Choose "Start from Dev Dashboard", enter OfferLab as the app name, then click "Create"
π Tip: You can also get to the Dev Dashboard from your Shopify admin by going to Settings β Apps β Develop apps β Build apps in Dev Dashboard.
Step 2: Configure Access
Enter https://offerlab.com as the App URL
Make sure "Embed app in Shopify admin" remains checked
Scroll down to the Access section and click Select scopes
Enable the following permission scopes:
read_products and write_products
read_orders and write_orders
read_inventory
read_shipping
Click Release to save and publish your app version
Step 3: Install the App and Get Your Credentials
In the Dev Dashboard, open your app and go to the Installs section
Click Install app and confirm
Go to the app's Settings page in the Dev Dashboard
Copy your Client ID and Secret β you'll need both in the next step
β οΈ Keep your Secret safe. Never share it publicly or include it in any code repository. If you think it's been exposed, rotate it immediately from the app's Settings page.
Step 4: Connect Shopify in OfferLab
In OfferLab, go to Settings β Connections and click Connect on the Shopify card
Click the Connect Shopify button
Enter your Store URL in the format yourstore.myshopify.com
Paste your Client ID and Secret
Click Connect Shopify
π Tip: Use your Shopify admin URL (e.g., yourstore.myshopify.com), not a custom domain like www.yourstore.com. Find it in Shopify under Settings β Domains β look for the URL marked Primary ending in myshopify.com.
Step 5: Import Your Products
Once connected, go to Sell β Library β Your products
Click Add product and select Shopify
Select the products you want to import and click Import
Troubleshooting
π "Shop URL must have exactly one subdomain and end with myshopify.com"
β Use your Shopify admin URL (e.g., yourstore.myshopify.com), not a custom domain. Find it in Shopify under Settings β Domains.
π "Not found" error when entering the Shopify URL
β Double-check for typos in your store name
β Make sure your Shopify store is active
β Close your browser and try again
π "Failed to connect" after entering credentials
β Make sure all 6 permission scopes are enabled
β Make sure the app version has been released and installed
β Double-check that the Client ID and Secret were copied correctly from the app's Settings page in the Dev Dashboard
