Start Strong
Sell Smart
Manage with Ease
Market to Success

Obtaining Shopify Migration Credentials

You must create a custom app in Shopify to generate API credentials required for migration.

 

 

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.
    Credentials_EN_01.png
Note: If you do not see this option, please ensure you have developer or administrator permissions for the store. If you manage multiple stores, select the Dev Dashboard belonging to the specific store. Do not create or use the app across stores or organizations.

 

 

II. Create a Custom App

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

 

 

III. Configure App Permissions

To configure API permissions for your custom app:

  1. On the app configuration page, locate the App URL field and enter the default address: https://shopify.dev/apps/default-app-home
    Credentials_CN_04.png
  2. Scroll down to the Access section and click Select scopes to configure API permissions.
    Credentials_CN_05.png
  3. Enable all read permissions under Admin API access scopes (excluding any Shopify Payments-related permissions), or copy and paste the following permissions into the input field:

ead_analytics,read_app_proxy,read_assigned_fulfillment_orders,read_audit_events,

read_customer_events,read_cart_transforms,read_all_cart_transforms,read_validations,

read_cash_tracking,read_channels,read_checkout_branding_settings,read_checkouts,

read_companies,read_custom_fulfillment_services,read_custom_pixels,read_customers,

read_customer_data_erasure,read_customer_merge,read_delivery_customizations,

read_price_rules,read_discounts,read_discounts_allocator_functions,read_discovery,

read_draft_orders,read_files,read_fulfillment_constraint_rules,read_fulfillments,

read_gift_card_transactions,read_gift_cards,read_inventory,read_inventory_shipments,

read_inventory_shipments_received_items,read_inventory_transfers,read_legal_policies,

read_delivery_option_generators,read_locales,read_locations,

read_marketing_integrated_campaigns,read_marketing_events,read_markets,read_markets_home,

read_merchant_managed_fulfillment_orders,read_metaobject_definitions,read_metaobjects,

read_online_store_navigation,read_online_store_pages,read_order_edits,read_orders,

read_packing_slip_templates,read_payment_terms,read_payment_customizations,

read_privacy_settings,read_product_feeds,read_product_listings,read_products,

read_publications,read_purchase_options,read_reports,read_resource_feedbacks,read_returns,

read_script_tags,read_shipping,read_content,read_store_credit_account_transactions,

read_store_credit_accounts,read_themes,read_third_party_fulfillment_orders,read_translations,

read_pixels

Note: read_orders only grants access to orders from the last 60 days. read_all_orders covers your complete order history and must be selected separately — if you cannot find the checkbox for it, you will need to submit a separate application to Shopify. See Step 4 below.
  1. Click Request access to enter the API access application page. Complete and submit your application and wait for Shopify's approval. Suggested reasons: report analysis, financial reconciliation, or data backup.
  2. Click Release to publish the version.
    Credentials_CN_06.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.
    Credentials_CN_07.png
  2. In the Shopify Partners dashboard, go to Distribution and select Custom distribution as the distribution method.
    Credentials_EN_08.png
  3. Enter your Shopify store URL in the field, and click Generate link to obtain the download link.
    Credentials_EN_09.png
  4. Copy the generated link and open it in a new browser tab to proceed with the installation.

 

 

V. Retrieve Credentials and Complete Migration

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

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