Start Strong
Sell Smart
Manage with Ease
Market to Success

Obtaining Shopify Migration Credentials

Due to recent adjustments in Shopify's official policies, Shopify stores will gradually discontinue support for generating API Access Tokens via the legacy method. To ensure a smooth store migration, please follow the new process below to obtain a Client ID and Secret for authorization.

Note: The new authorization process described below (using Client ID & Secret) is still in beta testing and is currently being rolled out gradually.
 

If your migration tool still asks for an API Access Token, please disregard this guide for now and continue using the previous authorization method.

 

 

I. Enter the Shopify Developer Dashboard (Dev Dashboard)

  1. Log in to your Shopify store admin and click on your account avatar or name at the top-right corner.
  2. Select Dev Dashboard from the dropdown menu.
    1.1.png
Note: If you do not see this option, please ensure you have developer or administrator permissions for the store.

 

II. Create a Custom App

  1. Once in the dashboard, click the Create app button in the top-right corner.
    2.1.png
  2. Select Start from Dev Dashboard.
  3. App name: Enter any name (e.g., "Migration Tool") and click Create.
    2.2.png

 

III. Configure App Permissions

  1. On the app configuration page, locate the App URL field and enter the default address: https://shopify.dev/apps/default-app-home
    3.1.png
  2. Click Configure to set the API scopes.
    3.2.png
  3. Crucial Step: To ensure data integrity during migration, you must check all permissions for the following two modules (excluding permissions related to Shopify Payments):
    • Admin API
    • Customer Account API
    • Recommendation: Select both read and write permissions for these modules.

3.3.png

  1. Click Release.
    3.4.png

 

IV. Install the App to Your Store

  1. After successfully releasing the version, click Home in the left-hand menu.
  2. Click the Install app button in the top-right corner.
  3. In the confirmation pop-up, select your store and confirm the installation.
Note: If the installation fails due to insufficient permissions, please check your permission settings or contact your account administrator.

 

(Optional) Troubleshooting: App Cannot Be Installed

If you encounter an error message stating "This app cannot be installed" when attempting to install, please follow these steps to generate a specific installation link:

  1. On the app details page, click Select distribution method.
    4.1_CN.png
  2. In the Shopify Partners dashboard, go to Distribution and select Custom distribution as the distribution method.
    4.2_EN.png
  3. Enter your Shopify store URL in the field, and click Generate link to obtain the download link.
  4. Copy the generated link and open it in a new browser tab to proceed with the installation.
    4.3_EN.png

 

V. Retrieve Credentials and Complete Migration

  1. Once the app is installed, click Settings in the left-hand menu.
    5.1.png
  2. Navigate to the Credentials section to find:
    • Client ID
    • Secret (Click the eye icon to reveal)

5.2.png

  1. Copy both strings.
  2. Return to the One-Click Store Migration app page, paste the credentials into their corresponding fields, and click Next to begin the migration.