Reorder

Open Source Subscription Medusa Plugin

Website | Documentation

What is Reorder?

Copy to clipboardReorder is an open source Medusa subscription plugin.

It adds recurring commerce capabilities to a Medusa store, including subscriptions, plans and offers, renewals, dunning, cancellation and retention flows, activity logs, and analytics.

Copy to clipboardReorder is built as a Medusa plugin with Medusa modules, workflow-backed mutations, Admin API routes, scheduled jobs, and Admin UI extensions.

What it includes

• Copy to clipboardSubscriptions
• Copy to clipboardPlans & Offers
• Copy to clipboardRenewals
• Copy to clipboardDunning
• Copy to clipboardCancellation & Retention
• Copy to clipboardActivity Log
• Copy to clipboardAnalytics

Current scope

Copy to clipboardReorder currently focuses on recurring commerce operations managed from the Medusa Admin.

Today, the plugin provides strong Admin coverage across the implemented domains. Customer self-service flows will be introduced in the near future as a Copy to clipboardReorder Subscription Starter.

Feature highlights

• Subscription lifecycle management
• Configurable plans and offers
• Renewal orchestration
• Dunning retries and recovery tooling
• Cancellation flows with retention offers
• Operational activity logs
• Subscription analytics and reporting

Installation

Copy to clipboardReorder is meant to be installed into an existing Medusa project.

1. Install the plugin

With Copy to clipboardnpm:

1
npm install @reorderjs/reorder

With Copy to clipboardyarn:

1
yarn add @reorderjs/reorder

2. Add the plugin to Copy to clipboardmedusa-config.ts

1234567
plugins: [
  // other plugins
  {
    resolve: "@reorderjs/reorder",
    options: {},
  },
]

3. Run Migrations

With Copy to clipboardnpm:

1
npx medusa db:migrate

With Copy to clipboardyarn:

1
yarn medusa db:migrate

4. Start your Medusa app

After adding the plugin, run your normal Medusa setup flow in your store project.

Local development

If you want to work on the plugin itself locally:

1. Clone the repository

12
git clone https://github.com/reorder-js/reorder.git
cd reorder

2. Install dependencies

1
yarn install

3. Publish the local plugin

1
yarn medusa plugin:publish

4. Add the plugin in your Medusa store

1
yarn medusa plugin:add reorder

5. Add the plugin configuration to Copy to clipboardmedusa-config.ts

1234567
plugins: [
  // other plugins
  {
    resolve: "reorder",
    options: {},
  },
]

6. Install store dependencies

1
yarn install

7. Start your Medusa store

1
yarn dev

Requirements

• Minimum: Medusa Copy to clipboard2.3+
• Recommended: compatible with Copy to clipboard@medusajs/medusa >= 2.4.0

Architecture

Copy to clipboardReorder is organized around Medusa-native building blocks:

• domain modules for subscription data and operational records
• workflows for business mutations and orchestration
• Admin API routes for plugin operations
• Admin UI extensions for management flows
• scheduled jobs for renewals, dunning, and analytics processing

Documentation

Project documentation lives in Copy to clipboarddocs/.

Useful starting points:

• Copy to clipboarddocs/README.md
• Copy to clipboarddocs/architecture/
• Copy to clipboarddocs/api/
• Copy to clipboarddocs/admin/
• Copy to clipboarddocs/testing/
• Copy to clipboarddocs/roadmap/implementation-plan.md

Contributing

Issues and pull requests are welcome.

Before changing behavior:

• read the runtime docs in Copy to clipboarddocs/
• keep implementation aligned with documented behavior
• follow Medusa best practices for modules, workflows, routes, and Admin UI extensions