Medusa Source Shopify
Plugin that allows users to source Medusa using a Shopify store.
Quick start
This plugin will copy all of your products and collections from Shopify to Medusa.
To get started with the plugin you should follow these steps.
Install the plugin
Navigate to your Medusa server in your terminal, and install the plugin.
Create a Shopify app
Navigate to your Shopify dashboard, and then go to
and click theCopy to clipboardApps
button at the bottom of the page. After navigating to theCopy to clipboardDevelop apps for your store
page, click theCopy to clipboardApp development
in the top right corner.Copy to clipboardCreate an app
This should open a modal where you can choose a name for your app. Write a name and click
.Copy to clipboardCreate app
You should then click the button that says
. Scroll down toCopy to clipboardConfigure Admin API scopes
and select theCopy to clipboardProducts
scope, and then save your changes.Copy to clipboardread_products
Go back to overview and click
. This should generate a token, that you should write down as you can only view it once.Copy to clipboardInstall app
Add the required plugin options
Update your
with the following:Copy to clipboardmedusa-config.js
You should then add
andCopy to clipboardSHOPIFY_STORE_URL
to yourCopy to clipboardSHOPIFY_API_KEY
.Copy to clipboard.env
The
is the token that we generated in the previous step.Copy to clipboardSHOPIFY_API_KEY
is the name of your store. You can view the name in the url of your Shopify dashboard, which has the following formatCopy to clipboardSHOPIFY_STORE_URL
.Copy to clipboard<your_store_name>.myshopify.com
Run your server
After setting everything up you can now run your server
and the plugin will handle the rest.
Note
The plugin only queries updates since last build time
The plugin stores everytime it is run, and will use this timestamp to only fetch products, collections and collects that have been updated in Shopify since the last time it pulled data.
Copy to clipboardProduct/Collection
relations (Copy to clipboardCollect
)
Copy to clipboard
Product/Collection
Copy to clipboard
Collect
Shopify supports products being part of more than one collection, but Medusa does not support this. For this reason a product will only be part of the first collection it has a relation to in Medusa. The plugin processes Shopify product/collection relations in the following order:
- Custom collections
- Smart collections
This means that if product
is part of custom collectionCopy to clipboardX
and smart collectionCopy to clipboardY
in Shopify, it will only be added to custom collectionCopy to clipboardZ
in Medusa.Copy to clipboardX

Build your own plugins
Develop your own plugins with our API to speed up your processes.
Make your plugin available via npm for it to be shared in our Plugin Library with the broader Medusa community.
.png)