How to connect the Shopify online store platform to Mergado Editor#

How to generate Shopify API credentials for Mergado (from January 1, 2026)#

⚠️ IMPORTANT connection instructions#

  1. Into the URLs > App URL field enter: https://app.mergado.com/ 💡You must enter this URL in the App URL field when creating a custom app in Shopify.

  2. Minimum permissions (scopes) required by Mergado. ⚠️ Without these permissions, the integration will not work.

write_products,read_products,write_markets,read_markets,read_metaobjects
  1. Permissions (scopes) if you also want to use Mergado Marketplaces
read_customers,write_customers,write_orders,read_orders,read_products,read_shipping,write_shipping,write_order_edits,read_order_edits

This guide strictly follows the official Shopify documentation and current user interface for creating apps using the Shopify Developer Dashboard.

Official sources: https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard

Who is this guide for#

This article is intended for:

  • Shopify merchants who want to connect their online store with Mergado
  • agencies and developers setting up the Shopify ↔ Mergado integration for clients
  • anyone who needs to obtain a Shopify API access token

You are creating a custom, purely API app for one specific online store. There is no need to publish the app to the Shopify App Store.

What you will need#

  • A Shopify account with admin access to the online store
  • Access to the Shopify Developer Dashboard

Before you begin: Check your Markets settings#

⚠️ This step is required for Mergado to be able to import products for individual markets.

Before creating the app, we recommend checking the Markets settings in the Shopify admin.

What needs to be configured#

For each market from which you want to import products into Mergado:

  • a domain must be assigned
  • a language must be assigned
  • both values must be explicitly added to the Customized section

It is not sufficient for them to only be inherited from the Inherited section or set as Primary.

Steps in the Shopify admin#

  1. Open the Shopify admin
  2. In the main left menu, click Markets
  3. Open a specific market (e.g. Czechia)
  4. Scroll to the Inherited section
  5. For the Domain / language item, click the + icon
  6. In the modal window:
  • check the desired domain
  • check the desired language
  1. Confirm by clicking Done
  2. Verify that Domain / language has moved to the Customized section
  3. Confirm changes by clicking Save :warning:

If Domain / language remains only in the Inherited section, the Shopify API will not provide data for that market and Mergado will not be able to import products.

Step 1: Open the Shopify Developer Dashboard#

You can access the Shopify Developer Dashboard in two ways:

Option A: Direct access#

  1. Open https://dev.shopify.com/
  2. Log in with your Shopify account
  3. In the left menu, open the Apps section

Option B: Via the Shopify admin#

  1. Open the Shopify admin of your online store
  2. Go to Settings → Apps
  3. Click Develop apps
  4. Click Build apps in Dev Dashboard

Step 2: Create a new app#

  1. Make sure you are in the Apps section
  2. Click Create app
  3. Choose Start from Dev Dashboard
  4. Enter an app name (e.g. Mergado integration)
  5. Click Create

After creating the app, you will be redirected to the Versions tab.

Step 3: Create an app version and set permissions (scopes)#

Each app must have at least one version before it can be installed in an online store.

3.1 Setting the app URL and embedding#

  1. In the URLs section, find the App URL field
  2. Replace the default value https://example.com with:
https://app.mergado.com

This step is required for the integration with Mergado to work correctly. If the default value remains, authorization will not function properly.

  1. Below the App URL field, uncheck the Embed app in Shopify admin option

3.2 Setting access permissions#

  1. In the Access section, click Select scopes
  2. In the modal window, search for and check:
    • read_products
    • write_products
    • read_markets
    • write_markets
    • read_metaobjects
  3. Confirm by clicking Done

These permissions are required for Mergado to be able to load products and market-specific data.

3.3 Publishing (Release) the version#

  1. Scroll down on the page
  2. Click Release
  3. In the confirmation dialog, you can leave the version name empty
  4. Confirm by clicking Release

The app version is now published and ready for installation.

Step 4: Install the app in your online store#

  1. In the left menu, open Home
  2. In the top right, click Install app
  3. Select the Shopify online store you want to connect with Mergado
  4. You will be redirected to the Shopify admin
  5. Confirm the installation by clicking Install

The app is now installed in the online store.

Step 5: Obtain the API access credentials (Client ID and token)#

After installing the app, you need to obtain two values that you will use for the integration with Mergado:

  1. Client ID
  2. API access token (Secret)

Steps:

  1. Go back to the Shopify Developer Dashboard
  2. Open your app
  3. Go to Settings
  4. In the Credentials section:
  • copy the Client ID value (the field is located above the Secret value)
  • copy the Secret value

Client ID is used to identify the app, Secret serves as the API access token. Both values are required for the Mergado integration to work correctly.

Step 6: Get the online store URL#

  1. Open the Shopify admin of the connected online store
  2. In the left menu, open Home
  3. In the Domains section, copy the online store URL

Example:

your-store.myshopify.com

Step 7: Connect Shopify with Mergado#

  1. Open Mergado
  2. Create a new project
  3. Select Shopify as the data source
  4. Fill in:
    • Shopify URL → enter the online store URL
    • Client ID → enter the copied Client ID from the Shopify Developer Dashboard
    • Client Secret → enter the copied Secret
  5. Click Log in

FAQ#

After selecting a Market, the language does not load. Why?#

The most common cause is in the Markets settings in the Shopify admin.

If Domain / language is listed only in the Inherited section and is not added to the Customized section, the Shopify API will not provide data for that market. As a result, the language will not load in Mergado after selecting a Market.

Solution:

  • Open Shopify admin → Markets
  • Open the specific market
  • For the Domain / language item, click +
  • Select the domain and language
  • Click Done and then Save
  • Verify that the item has moved to the Customized section
  • More info in the section: Before you begin: Check your Markets settings

Mergado does not load the values of some metafields correctly. Why?#

If some metafields display the correct name (key) but the value is shown as an ID (e.g. ["gid://shopify/Metaobject/94942036012"]) or a “Missing required scope” message appears, the app is missing the permission to read metaobjects.

You need to add the following scope:

read_metaobjects

Steps#

  1. Go to the Shopify Developer Dashboard
  2. Open the app created for the Mergado integration
  3. In the left menu, go to Versions
  4. Click New version
  5. In the Scopes section, add the new scope read_metaobjects
  6. Confirm the changes and complete the new version by clicking Release

After releasing the new version, you need to re-authorize the connection.

Re-authorization in Mergado#

  1. Open the Mergado Keychain extension
  2. Remove the existing connection
  3. Re-enter the authorization credentials:
  • Shopify URL
  • Client ID
  • Secret
  1. Log in again (Log in)

After adding the scope and re-authorizing, metafield values will load correctly.

Related articles

  • Assortment Report in Mergado How the Heureka assortment report works in Mergado -- report generation and download process for Bidding Fox and other extensions.
  • CDATA in Mergado Explanation of CDATA in XML feeds and a guide on how to wrap elements in CDATA in Mergado using the Elements tab or the Rewrite rule.
  • Calculating and Filtering Percentage Discounts in Mergado How to calculate the percentage discount between the original and sale price in Mergado and filter products by discount level using MQL queries.
🇨🇿 🇬🇧 🇩🇪 🇭🇺