Skip to main content

​
Prerequisites

Reorder is a plugin for an existing Medusa store. If you don’t have one yet, create a Medusa application first, then come back here. Once you have a running Medusa store, make sure it meets the version requirements:
RequirementMinimumRecommended
@medusajs/medusa2.3.0>= 2.4.0
Node.js20Latest LTS
Reorder is not compatible with Medusa 1.x. It relies on modules, workflows, and Admin UI extensions introduced in Medusa 2.x.

​
Installation

1

Install the plugin

In your Medusa application, add @reorderjs/reorder using your preferred package manager.
npm install @reorderjs/reorder
2

Register the plugin

Open medusa-config.ts and add Reorder to the plugins array.
medusa-config.ts
plugins: [
  // other plugins
  {
    resolve: "@reorderjs/reorder",
    options: {},
  },
]
3

Run migrations

Apply Reorder’s database migrations from your Medusa application directory.
npx medusa db:migrate
4

Start your store

Run your Medusa server. Reorder will register its modules, API routes, scheduled jobs, and Admin UI extensions on boot.
npm run dev
5

Open the Admin

Navigate to your Medusa Admin dashboard. You will see a Subscriptions entry in the sidebar with access to Plans & Offers, Renewals, Dunning, Cancellations, Activity Log, and Analytics.

​
What gets added to your store

Once the plugin is loaded, Medusa boots with the following additions from Reorder:
ComponentWhat it provides
Admin UI extensionsDedicated pages for Subscriptions, Plans & Offers, Renewals, Dunning, Cancellations, Activity Log, Analytics, Subscription Settings, plus an order-detail subscription widget
Admin API routesProtected REST endpoints under /admin/ for all subscription operations, settings, and analytics queries
Store API routesCustomer-facing endpoints under /store/ for subscription checkout and offer resolution
Scheduled jobsRenewal execution, dunning retry scheduling, and analytics roll-up jobs that run on configurable cadences

​
Next steps

  • Core Concepts — understand the subscription lifecycle, plan model, and renewal flow
  • Plans & Offers — create your first subscription plan and attach it to a product
  • Subscription Settings — tune dunning intervals, trial defaults, and renewal behavior