Requirements and compatibility

Everything you need before installing Reorder: minimum Medusa version, Node.js version, and full package compatibility requirements.

Before you install Reorder, verify that your environment meets the version requirements below. Running an incompatible version of Medusa is the most common cause of installation issues.

Medusa version

Requirement	Version
Minimum	Medusa 2.3+
Recommended	@medusajs/medusa >= 2.4.0

Reorder relies on Medusa modules, workflow primitives, Admin UI extensions, and scheduled jobs that were introduced in Medusa 2.x. It is not compatible with Medusa 1.x.

Check your Medusa version

Run the following command in your Medusa project to see the installed version:

npm list @medusajs/medusa

Or with yarn:

yarn list --pattern @medusajs/medusa

If the output shows a version below 2.3.0, upgrade Medusa before proceeding.

Node.js version

Reorder requires Node.js 20 or later. This matches the engines field in the plugin package.

node --version

The output should be v20.x.x or higher.

Package name

The plugin is published to npm under the scoped package name @reorderjs/reorder.

npm install @reorderjs/reorder

Make sure you are installing @reorderjs/reorder (with the @reorderjs/ scope), not an unscoped or differently named package.

Summary

Requirement	Minimum	Recommended
@medusajs/medusa	2.3.0	>= 2.4.0
Node.js	20	Latest LTS
Package	@reorderjs/reorder	Latest

Once your environment meets these requirements, follow the quickstart to install and configure the plugin.