Shopify to Medusa Data Migration: A Step-by-Step Guide

Step 1: Create a Private Shopify App

To import data from Shopify into Medusa, you must create an app in your Shopify store with specific permissions. This app will provide the keys needed to access the data in your store.

Start by opening your store’s dashboard. Next, select Apps from the sidebar. Scroll down and click on Manage private apps. This will allow you to create an app with the required access.

Click on Create private app to get started

You’ll then need to enter your app’s name and your email. Then, scroll down to the Admin API section and click Show inactive Admin API permissions. Scroll down to Products and choose Read Access from the dropdown. Medusa only needs to read products and collections.

Scroll to the end of the page and click the Save button. Then, click Create App in the pop-up that appears.

After you create the app, you’ll be able to see a set of keys such as API Key and Password. You’ll need the API key and password later, so note it down for the next step.

Step 2: Add medusa-source-shopify to your Medusa store

You’ll now connect the Shopify plugin to your Medusa server. To integrate the plugin, you need the following:

1. The Shopify domain name and the password of the Shopify app you want to link to.

2. PostgreSQL database used with your Medusa server.

Open your terminal in your Medusa server installation and run the following command to install the plugin:

npm i medusa-source-shopify

Then, in the .env file, add the following new variables:

   SHOPIFY_DOMAIN=
   SHOPIFY_PASSWORD

Where SHOPIFY_DOMAIN is the subdomain name of your Shopify store (for example, my store is outreachright.myshopify.com, so the value would be outreachright), and SHOPIFY_PASSWORD is the password generated when you created the app earlier.

Then, open medusa-config.js and add a new entry into the plugins array:

const plugins = [
      ...,
      {
        resolve: 'medusa-source-shopify',
        options: {
          domain: process.env.SHOPIFY_DOMAIN,
          password: process.env.SHOPIFY_PASSWORD
        }
      }
    ];

This will add the Shopify plugin to your Medusa server and pass the domain and password options from the environment variables you just added.

And that’s all you need to integrate Medusa with Shopify to import your data. All you need to do now is run your server:

npm start

The server will import all the products and collections from Shopify into your Medusa store. It will do that every time you start it, so your products and collections will be synced automatically when it restarts.

Your products and collections will be imported with pricing, variants, and all the attributes and details you had in your Shopify store.