Built by






Last updated

Sep 5, 2023, 08:41:38 AM9 months ago

Prestashop Source Plugin for Medusa

A Medusa plugin that imports categories and products from Prestashop into Medusa.


This plugin imports Prestashop categories and products into Medusa. It creates categories and products that don't exist and updates those that have been imported previously.



Medusa Setup

You must have a Medusa server installed before installing this plugin.
Furthermore, the Medusa server should have PostgreSQL, Redis and File Service installed and configured on your Medusa server.

Prestashop Setup

Go to the PrestaShop back office, open the “Web service” page under the “Advanced Parameters” menu, and then choose “Yes” for the “Enable PrestaShop Webservice” option.
Generate a key and copy it as you'll need them for the plugin's options.
You need to give at least the integration access to the following resources:
  • products
  • product_options
  • product_option_values
  • combinations
  • categories
  • stock_availables
  • images
We recommend enabling all the resources.

Installing Plugin

To install the plugin run the following command on your Medusa server:
npm install medusa-source-prestashop

Plugin Configurations

Add the plugin and its options into the
Copy to clipboard
array in
Copy to clipboard
const plugins = [
resolve: `medusa-source-prestashop`,
//if your plugin has configurations
options: {
prestashop_url: '<YOUR_PRESTASHOP_URL>', // example 'https://prestashopstore.com/api',
additionalParams: {}
generateNewHandles: boolean


NameDescriptionRequiredDefault Value
Copy to clipboard
The URL of your Medusa server. It should end with a /api.true
Copy to clipboard
The Consumer Key of the integration.true
Copy to clipboard
Should the importer generate new handles or use link_rewrite in prestashop productfalse
Copy to clipboard
Copy to clipboard
Additional parameters to send when making Prestashop webservice requestfalse
Copy to clipboard

Use the Plugin

Server Startup

To use the plugin, just start the Medusa server:
npm start
The import process will run in the background of the server. Based on how many products you have, it can take some time the first time running it.

As a Batch Job

You can trigger the import by creating a new batch job using the Create Batch Job API endpoint. You can pass the following in the payload:
"type": "import-prestashop",
"context": {},
"dry_run": false
This will trigger the import process.

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.