Migrating Your Shopify Store to SHOPLINE

To help you transition to SHOPLINE quickly while maintaining business continuity, SHOPLINE provides the Multi-platform Store Migration app — a one-click migration tool that transfers store data from supported platforms.

This guide explains how to migrate your Shopify store to SHOPLINE using the Multi-platform Store Migration app. Follow the steps below to prepare your Shopify store, complete the migration, and understand important migration considerations.

For the migration of your WooCommerce or Shoplazza store, refer to the following articles respectively:

• Migrating Your WooCommerce Store to SHOPLINE
• Migrating Your Shoplazza Store to SHOPLINE

Overview of the Shopify Migration Process

Migrating from Shopify to SHOPLINE involves the following 6 stages:

Preparing Your Store for Migration

Before starting migration, complete the following preparation steps to avoid disrupting normal store operations due to data migration:

• Turn off email notifications: Turn off email notifications in the SHOPLINE merchant admin and third-party apps (such as CRM, Smartpush, etc.) to prevent data writes from triggering notifications that disturb customers.
• Notify your payment channel: Notify your payment channel that your store will be switching SaaS platforms, to avoid disrupting payment functionality.
• Update the default location name: Update the SHOPLINE default location name so it matches your original Shopify store's location name, to prevent abnormal inventory deductions caused by order data migration.
• Back up ad data (optional): Before migrating, back up the feed files from your original ad channels and confirm your original product IDs — this can serve as a reference for verifying whether ad data migrated successfully.
• Clear product data (optional): If you plan to migrate your product feed, note that products written by apps other than the migration tool cannot be matched in the feed. Be sure to clear existing SHOPLINE product data beforehand.
• Migrate your domain (optional): If your domain is purchased or renewed through Shopify, transfer it to a third-party provider first.

Obtaining Shopify Migration Credentials

Before selecting migration modules, you need to complete Shopify store authorization so the one-click migration tool can read your store data.

After creating your store, but before setting up your storefront design, install and authorize the one-click migration tool:

• Go to the SHOPLINE App Store, then search for and install Multi-platform Store Migration.
• On the app page, enter your Shopify store domain. Three domain formats are currently supported: handle, handle.myshopify.com, and admin.shopify.com/store/handle.
• Enter your Client ID and Secret, then click Next to begin migration.

Selecting Data Modules to Migrate

Once store authorization is complete, you can select the data modules you want to migrate. Dependencies exist between different modules — check the table below to confirm the migration order before selecting modules to migrate:

Recommended Module Migration Order

1. Store Assets, Products, Customers, Custom Pages, Blog, Translations
2. Shipping & Fulfillment, Gift Cards, Customer Segments, Metaobjects
3. Discount Codes, Metafields
4. Orders & Abandoned Checkouts (order creation is irreversible — make sure the Products and Customers modules have fully migrated first)

Strong Dependency Rules

Some modules have strong business data dependencies on one another:

1. Gift cards depend on customer data. If customer data hasn't been migrated, gift cards linked to those customers will fail to migrate.
2. Discount codes depend on product and customer data. If product or customer data hasn't been migrated, campaigns with a "specified scope" will fail to migrate.
3. Orders and abandoned checkouts depend on product and customer data. If product or customer data hasn't been migrated, order data will be abnormal and cannot be corrected.

When gift cards, discount codes, and orders are migrated in the same batch as the base modules they depend on, if the base module's migration success rate doesn't meet the threshold (below 95%), the system will not proceed to migrate gift cards, discount codes, or orders.

Example: Gift cards depend on customers — if the customer module's success rate doesn't meet the threshold, gift card migration will not run.

Gift cards, discount codes, and orders can be migrated separately when the following conditions are met:

• The dependent module's most recent full migration was within the last 90 days. A full migration means no custom scope was set (migration scope is "All"); it excludes records where the migration task was interrupted or terminated.

The dependent module's most recent full migration success rate is 95% or higher. If it doesn't meet this threshold, you can use Retry on failed data to refresh the success rate.

Syncing Ad Data During Migration

If you're currently running Google or Meta ads, complete the following steps based on your chosen tool to ensure ad performance isn't interrupted after migration:

• Use the official SHOPLINE Smart Feed app (recommended): After completing your core store data migration, we recommend installing the Smart Feed app. It supports migrating your product feed from Shopify, and lets you complete all configuration within the app to ensure ID matching. For details, see "Smart Feed (New): Migrating Product Feeds from Shopify, WooCommerce, and Shoplazza (Limited Access)."
• Use the third-party Simprosys app: If you choose to use Simprosys to migrate Google or Meta ad data, you'll need to set feed rules in the migration plugin and complete the migration there. Be sure to clear any non-migrated products already in your SHOPLINE store before starting, to avoid feed matching failures.

Handling Migration Failures

After migration completes, some data may fail to migrate due to system errors or data that doesn't meet requirements. You can review and handle this failed data by module:

1. Once migration ends, review the details of failed migration data on the migration results page.
2. Failed data can be exported by module, with an export limit of 10,000 records per migration. If a single module's failed data exceeds this limit, we recommend analyzing and resolving some of the failures first, then clicking Retry before attempting to export again.

For common error causes and fixes, see "Troubleshooting Common Store Migration Failures".

Secondary Migration: Migrating Incremental Data

If you've already completed a full migration but still need to migrate newly added data (for example, before switching your domain), you can initiate migration again — this is called a "secondary migration":

• Incremental data: Orders and abandoned checkouts support filtering by creation time, so you can specify a "start time" to precisely target your migration range.
• Already-migrated data: Already-migrated data is not overwritten by default, but you can choose whether to overwrite it:

Completing Migration and Binding Your Store Domain

Once data migration is complete, you can continue setting up your store, including storefront template configuration, payment setup, ad pixel setup, meta verification, sitemap submission, and more.

Once your store is fully set up, you can bind your Shopify-exclusive domain to SHOPLINE and officially launch your store.

Migration Considerations

Issues Related to Migration of the Orders Module

• The data of migrated orders will be displayed 24 to 48 hours after your migration is completed.
• The migrated Shopify orders and the amount will be created in a customized payment method by default. Although you can refund these orders, no actual refunds will be generated. You need to complete the refund operations offline or on Shopify.
• In the event that migration of the products or customer in an order fails, the order will still be migrated and created, but with a custom customer and custom products. This may lead to order shipping or refund failures because there are no matched products related to the shipment or refund.
• At present, migration of the logistics method field is not supported, but that of the logistics status is supported.
• At present, migration of the order return status is not supported, because Shopify doesn’t provide the interface for inquiring order returns.
• How many Shopify locations can be migrated is based on the number of locations included in the plan you have purchased for your SHOPLINE store. If the number of locations for your SHOPLINE store is less than that of your Shopify store, location migration will fail.
• At present, product images are not displayed on the order details page for POS channel orders.
• Please turn off the order-related email notifications in Settings > Notifications in your SHOPLINE admin panel before the order migration.
• When products in a Shopify order are removed, the migrated order retains the activated/listed status in SHOPLINE, because the Shopify interface doesn’t provide product status information. This may result in a partially paid or partially shipped status of the order after the migration, because a removed product doesn’t have payment or shipping information.
• In Shopify, orders are displayed in the same currency as they are paid in. However, migrated orders will be displayed in the currency configured for your SHOPLINE store, which may result in inconsistencies with your Shopify order currency. 
• The migration of multi-currency orders is supported. However, cancellations and refunds for these orders are not yet supported, which may result in inconsistencies with your Shopify order statuses.

Other Issues

• After migrating the customer data from the Shoplazza store, customers need to verify their email to activate their accounts by email since the data come from two different systems. You can go to Settings > Customer account > Classic customer account in the SHOPLINE admin panel, and select the Activation method option. Customers can then reactivate their account with the verification code sent via email when trying to log in your store.

• For the migration of logistics settings, only the general plans are migrated. Custom plans configured based on products are not supported. Migration is not supported when both a general shipping plan and a custom shipping plan exist at the same time.
• Your SHOPLINE store needs to enable phone number sign-in. Otherwise, customers who registered with only phone numbers are not able to login after your store migration. You can go to Settings > Customer account to check the configuration.
• To ensure product images display correctly on your storefront after migration, make sure your images are in a format supported by SHOPLINE:

• Supported formats include: .gif, .pjp, .jpg, .pjpeg, .jpeg, .jfif, .png, .bmp, .webp, .svg, .ico, and .avif (maximum file size: 10 MB).
• Animated GIFs are also supported, with a maximum file size of 8 MB.
• For square product images, the recommended size is 800 × 800 pixels.
• For more details, see "Adding Images, Videos, and Files to Products".

• See the table below for supported sorting rules for smart and manual categories. You can re-confirm product sort order in the admin afterward, to avoid a drop in store conversion caused by incorrect migration order.
  Sorting rules supported by migration:

• Smart category classification rules:

Frequently Asked Questions

Q1: Why is the displayed quantity of migrated products inconsistent with the actual number of migrated products?

The quantity of migrated products includes the quantity of products, SKUs, categories, and binding relations between products and categorization.

Q2: Why does the number of customers displayed in the admin panel differ from the number of migrated customers?

Because customer statistics are not updated in a real-time manner, there is a data delay of about 1.5 hours (for example, if 40,000 customer data is migrated, the total number displayed in the admin may be only 20,000, and it will take over an hour for the data to be updated and displayed correctly).

Q3: Why is the status of migrated customers "disabled"?

It means this customer isn’t activated in Shopify, so it is deactivated in SHOPLINE. The term for this status has been optimized "not activated" for improved customer experience. Start another migration to overwrite the obsolete status.

Q4: When migrating customers, will their Email and SMS subscription statuses also be transferred and saved?

Yes, customers' subscription preferences for both Email and SMS will be carried over and saved during the migration.

Understanding the Scope of Supported Migration Data

The table below lists the data fields supported by the Multi-platform Store Migration app when migrating a store from Shopify to SHOPLINE. It helps you understand which types of data can be migrated. 

Product Data

Customer Data

Order Data