Start Strong
Sell Smart
Manage with Ease
Market to Success

Obtaining Shopify Migration Credentials

Migrating your store to SHOPLINE requires secure access to your Shopify store's data, such as products, orders, and customers. Shopify provides this access through API credentials generated by a custom app, which connects the migration tool to your store without exposing your login information. 

This article explains how to access the Shopify Developer Dashboard, create and configure a custom app, install it on your store, and retrieve the credentials needed to complete your migration.

 

 

Accessing the Shopify Developer Dashboard

To access your Shopify Dev Dashboard, follow these steps:

  1. Log in to your Shopify store admin.
  2. Click on your account avatar or name in the upper-right corner, then select Dev Dashboard from the dropdown menu.
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.

Credentials_EN_01.png
 

 

Creating a Custom App

To connect your Shopify store to the migration tool, you must first create a custom app in the Shopify Dev Dashboard. Follow these steps to create a custom app:

  1. In the dashboard, click Create app in the top-right corner.
    Credentials_CN_02.png
  2. Select Start from Dev Dashboard.
  3. In the App name field, enter a name for your app (for example, Migration Tool), then click Create.
    Credentials_CN_03.png

 

 

Configuring 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.
    Credentials_CN_05.png
  3. Under Admin API access scopes, enable all read permissions except those related to Shopify Payments. Alternatively, copy and paste the following permissions into the input field:
read_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: The read_orders permission grants access only to orders from the last 60 days. To access your complete order history, you must also enable the read_all_orders permission. If you do not see the read_all_orders option, submit a separate access request to Shopify. For more information, 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. After your request is approved, click Release to publish the version.
    Credentials_CN_06.png

 

 

Installing the App to Your Store

After creating and publishing your custom app, you must install it in your Shopify store before it can be used. Follow these steps:

  1. After successfully releasing the app 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: Unable to Install the App 

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

 

 

Retrieving Credentials and Completing 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 Multi-platform Store Migration app, paste the credentials into their corresponding fields, and click Next to begin the migration.