Created: 12/2021
Latest updated: 09/2024 – Updated version: 1.2.3
By: VillaTheme
Thank you for purchasing our plugin. If you have any questions that are beyond the scope of this documentation, please feel free to request support at our Support Forum. Thanks so much!
System Requires
Make sure that those limits to a minimum as follows in order for free-trouble while installing:
Recommended:
DOWNLOAD PLUGIN
Get the plugin installation package from your account download page and save it to your desktop.
INSTALL & ACTIVATE PLUGIN
Go to Plugin/Add New /Upload Plugin/Choose file/ select the plugin file installable zip file w2s-migrate-woocommerce-to-shopify.zip / Install Now/Active Plugin
Let’s see this video guide on how to install and use the plugin:
After you finish installing the plugin, first, you would need to connect your WooCommerce store with your Shopify store with the credentials below:
Step 1: Go to plugin settings >> “Woo to Shopify” >> General settings
Step 2: Configure the Store address, API key, and API access token or API secret fields.
Step 3: Save the settings.
Important note: You can add as many Shopify stores as you want with the “Add store” button. If you have many Shopify stores, each store will have its own importing area.
Fill in your Shopify store URL, it should look like myshop.myshopify.com.
Please go to Shopify admin > Settings > Domains > Get the store domain
After the credentials above are added correctly and saved successfully, now the plugin will show these 2 tabs, which were invisible previously.
Now you can start to migrate products from your WooCommerce store to your Shopify store.
If you have too much data of Products, Users and Orders to import, go to General settings >> Config import to divide the data entry process into small batches to avoid loading too much data at once, which leads to the data can’t be loaded properly.
Change the value in the “Number per page” option according to the need to adapt it to your site.
Enable this option to get default product when translating product using WPML
You can learn the video on how to create a custom app and connect Shopify API using an Access token.
As stated in the previous part, to get the plugin to work, you would need to connect your WooCommerce store with your Shopify store.
To do that, you must have your development store, and get the API credentials, please follow the steps below:
Step 1: Creating your Shopify development store
Step 2: Enable custom app
On the Shopify dashboard, go to the App settings as in the picture below >> Click “Develop apps”
Then, follow the steps in this instruction to enable custom app development from the Shopify admin.
Step 3: Create an app
Click “Create an app” to create a custom app. And follow the next steps in this instruction for the whole process to create a custom app.
Note: In the past, Shopify used to allow users to create private apps, but this feature was removed, as mentioned in this statement. If any users who have been using our plugin since then, the private app credentials in your plugin settings will still be kept and work properly.
Step 4: Assign API scopes
After successfully creating a custom app, the next step is to assign API scopes to it. Please visit this instruction for specific steps. To find the scopes based on what you need to import, please see the table below:
Step 5: Install the app
After you’ve set API scopes for your app, you can install the app. You’ll get your API access tokens after you install. Depending on what API scopes you assigned to the app, you’ll get an Admin API access token, a Storefront API access token, or both.
IMPORTANT NOTE:
You can see the Admin API access token on this page only one time, because the token provides API access to sensitive store data. After revealing the access token, write down or record the token somewhere secure so that you can refer to it again. Treat the token like a password. Share the access token only with developers that you trust.
Now the custom app is created and installed successfully, the next step is to get the API credentials and place them to the plugin General settings.
The admin can synchronize the imported product and order data manually.
Step 1: In the WooCommerce Product list, select the products you want to synchronize, then click “Sync to Shopify”
Step 2: A popup will appear for you to select:
Step 3: After selecting the domain and the options:
Note: You can only sync the imported product. In the image below, there are only 5 products that were imported, even if the other products are also selected, they will not be added to Shopify.
You can also sync each particular product by hovering over the product title, the “Sync” button will appear, and clicking it will lead you to a popup as above, but only sync that product data only.
When the process is finished, you can see the status to know if the data was synced successfully or not
The status will let you know:
In the WooCommerce Orders list, you can do the same as in the WooCommerce Product list above.
Step 1: In the WooCommerce Order list, select the orders you want to synchronize, then click “Sync to Shopify”
Step 2: A popup will appear for you to select:
Step 3: After selecting the domain and the options:
Note: You can only sync the imported orders.
You can also sync each particular product by hovering over the product title, the “Sync” button will appear, and clicking it will lead you to a popup as above, but only sync that product data only.
When the process is finished, you can see the status to know if the data was synced successfully or not.
The status will let you know:
Starting from version 1.2, our plugin allows you to sync product and order data between Shopify and WooCommerce. This feature enables you to keep your data up to date across both platforms. In order to initiate the syncing process, please follow the steps below:
Step 1: Connect Shopify Store.
In the W2S plugin settings, navigate to the “General settings” section and connect Shopify API. You can see this guide in the General settings.
Step 2: Sync products/Orders
To ensure that you sync order data to the desired Shopify store, you need to select a shopify store.
To sync product data reversely from Shopify to WooCommerce, from version 1.2, please follow this guide link.
To sync order data reversely from Shopify to WooCommerce, from version 1.2, please follow this guide link.
Those who have previously used Shopify’s previous version can continue to connect to the API through a private app as usual. Let’s see this video guide on how to connect WooCommerce and Shopify using a Private App.
Please note that private apps are deprecated and can’t be created as of January 2022. If you’re using a private app which was created before, you can still use this API in our plugin to migrate. If you’re new, please ask your app developer to create a custom app. Like private apps, custom apps are built exclusively for your shop, but they don’t require open API access to your store or access to your Shopify admin.
* Important note:
Just like the custom app, after you finish configuring the API credentials, the 2 tabs below will appear letting you migrate from the WooCommerce store to the Shopify store:
An important part of migrating from WooCommerce to Shopify is configuring the importing options.
With the plugin, you can migrate Products, Product categories, Orders, Customers, Coupons, and Shipping Zones. Each part has its own data settings for you to decide which to import, and which to exclude, the data migration will be proceeded based on these settings.
So you would need to configure all these settings according to necessity. Please visit the documentation of each part you need to configure:
Save the settings
And start to import.
After you’ve done all the settings configuration, scroll down to start importing data.
Important note: Our plugin processes imports sequentially from top to bottom, as certain data must be imported before others to ensure accuracy. Specifically, Product, Customer and Coupon information must be imported before order data. If this sequence is not followed, it may result in errors. Please be mindful of this caution, especially if you intend to import only specific data.
To import data, simply check and make sure you’re happy with all the configured options, then select which data you want to migrate for each store, then click “Import”
After you click “Import“, a progress bar will appear, along with a direct log letting you check the migration directly.
When the process is done, you will receive a notification, for example:
Important Note:
You can import metafields from WooCommerce to Shopify.
For example, if you want to import the meta title and meta description of products created by the Yoast SEO plugin from WooCommerce to the title and description on Shopify, you will need to use the Import Product Metafields feature.
Go to the Dashboard > Woo to Shopify > Products > Import Product Meta fields
It is essential to input the correct metakey from Yoast SEO in WooCommerce and the corresponding metakey in Shopify to ensure proper data matching and mapping.
On WooCommerce
If you are unsure of the exact metakeys for the metafields, you can use a third-party plugin that displays all metakeys. For example, JSM Show Post Metadata.
After you download and install a third-party plugin that displays all metakeys, go to the product editing page. You will see all available metakeys from plugins on your site, locate and copy the metakeys you need, then paste to the From WooCommerce fields in the Import Product Meta fields setting
On Shopify
Go to Settings > Custom data > Add definition (If you have not previously defined custom metafields for the meta title and meta description of products), you will add new definitions for the meta title and meta description of products on Shopify.
Add the meta title, select the Single line text type, and copy the generated metakey for the title, paste it to the To Shopify fields in the Import Product Meta fields setting.
Add the meta description, select the Multi-line text type, and copy the generated metakey for the description, paste it to the To Shopify fields in the Import Product Meta fields setting.
In each store setting, you’ll find the tab for each part you want to migrate data, configure all the options here. Starting from Products settings.
1. Filter by product type: This filter allows you to select a product type to migrate, they can be:
2. Include product: Just migrate the products that you enter here.
3. Exclude product: The Migrate WooCommerce to Shopify plugin will migrate all products except the products that you enter in the exclude product field.
4. Include product by categories: Simply migrate the categories in which you enter their title here.
5. Import product created date: Simply migrate the products created during the date range.
6. Import product sequence: Choose the sequence for imported products. There are 6 options to select:
7. Choose product images size: When importing image sizes into Shopify, you can select different options, with the default value set to “Full.”
8. Check exist: By default, this option is disabled -> And the plugin will ignore previously imported products. Enable this option to double-check all products before importing. The plugin will scan all products in Woo (including those previously imported) and check if the product entered in Shopify is still on Shopify, if not, the product will be re-imported to Shopify.
Note: Enabling this option will slow down the migration process speed.
9. Import attribute simple product: Import attribute of simple product as metafield
10. Get short description: Enable this option to import a product short description instead of a description
11. Keep product slug: The product slug after migrating to Shopify will remain, the same as in your WooCommerce store. If this option is turned off, WooCommerce will automatically generate a product slug from the product name.
12. Import product tags: Enable to migrate all WooCommerce product tags of the product to Shopify
13. Import product SKU: Enable to import of the SKU of all WooCommerce products to Shopify.
14. Check Point of Sale channel: Choose the Point of Sale channel in Shopify
15. Product status mapping: Map the WooCommerce product status to the corresponding Shopify product status. WooCommerce products when imported to Shopify, their status will be the selected status in the “To Shopify” column.
16. Import Product Meta fields: Import the WooCommerce product meta fields. You can view how to Import Metadata (Case study) here.
The next tab is the migration settings for product categories
This setting section allows you to configure the options before starting to import order data from WooCommerce to Shopify.
Configure settings in this tab for user’s data migration. In Shopify, users can’t purchase without logging in, the plugin will get the data from the “Users” data in your WooCommerce store, and the data import will go to the “Customers” tab in your Shopify store.
Configure the options in this tab. The coupon data the plugin gets from your WooCommerce store will be imported to the “Discount” in your Shopify store.
The last migration setting is the Shipping Zones.
The plugin will take the shipping zone data in your WooCommerce settings >> Shipping >> Shipping zones and import them to the Shopify Location.
Choose Shopify locations to import: The location in your Shopify store settings will appear in this field. Choose the location to import the Shipping Zones to.
Important note: After you finish importing Shipping Zones, you would need to add products for each zone manually in each profile. Because in WooCommerce, the shipping zones are for all products by default, it does not divide into different zones.
Step 1: Go to Shipping and delivery >> App shipping profiles >> Click “Manage” of each zone
Step 2: Add product manually
This function helps to automatically update and synchronize the imported product data from WooCommerce to Shopify. This is basically a timer tool to automatically synchronize products in a particular set time range.
Note: Please select at least one store in option (7) first before configuring any other option on this setting page.
The Logs section provides a detailed record of your import history, allowing you to track and review the data that has been imported. By checking the logs, you can verify the success of each import, identify any errors, and ensure that all product data has been correctly imported. This feature is particularly useful for troubleshooting and auditing the import process.
You can view logs of the import history by going to Woo to Shopify > Logs, the first thing you will see is the list of existing log files.
The file contains the logs generated during the import process. You can view it to review the details of the data imported from WooCommerce to Shopify and identify any issues or errors that may have occurred during the process.
Sometimes the items can’t be imported successfully, due to unsatisfactory conditions. Our plugin will let you know the migration status, no matter they are successful or not, via messages, they are as followings:
Please only use this function in a specific scenario: when you need to delete the history of the imported data from WooCommerce to Shopify in the previous imports, and reimport from scratch on WooCommerce.
* Please note that this function does not facilitate clearing data on Shopify.
For any other cases, refrain from using this function as the removed data cannot be recovered once cleared. Exercise caution and only clear data when it is absolutely necessary.
This function is designed specifically for situations where you have removed all imported data on WooCommerce and need to re-import the data from WooCommerce to Shopify. Removing all imported data may leave remnants on the WooCommerce site, making successful re-importation challenging even with the “Check exist” function enabled. In such cases, you can utilize this function to clear the data and proceed with the importation process.
To use this function, you must:
Step 1. Delete imported data on WooCommerce.
Step 2. Then clear corresponding data on WooCommerce
Step 3. Then reimport.
