Reorder: Open-Source Subscriptions Plugin for Medusa

Subscriptions have been a long-requested capability in the Medusa ecosystem, and earlier this month, Krzysztof Marut and Tomasz Kasperski released their new open-source plugin to change this.

Reorder is a new MIT-licensed, open-source subscription plugin purposefully built for Medusa with full control of the source code and no extra fees. One early adopter, Roastloop, launched coffee subscriptions in 7 days with it.

Learn how you get started from their documentation.

How Reorder works

Reorder is built the way Medusa is meant to be extended: as a native plugin using Medusa modules, workflow-backed mutations, scheduled jobs, Admin API routes, and Admin UI extensions. Subscriptions live next to your orders, carts, payments, and customer data. As the authors put it, "there is no second source of truth." No external vendor platform to sync with, and no cut of your recurring revenue, unlike other platforms that typically charge 1-2% of GMV.

Out of the box, Reorder gives you:

• Lifecycle management: create, pause, resume, skip, and cancel subscriptions, with lifecycle state and upcoming renewals tracked in the Admin.
• Dunning flows with retries: automatic payment retry scheduling with configurable intervals and manual recovery actions.
• Admin UI extensions: subscriptions, renewals, dunning cases, and analytics managed directly inside the Medusa Admin.
• Self-service APIs for customer portals: Store API endpoints for subscription checkout, offers, and customer subscription management, so shoppers can skip deliveries or update payment methods themselves.
• Analytics: MRR, churn rate, LTV, and active subscription counts with filterable trend charts.
• Plans and offers: subscription frequencies, per-frequency discounts, trials, and minimum cycle rules at the product or variant level.
• Cancellation and retention flows: pause offers, discounts, and bonuses presented before a cancellation is finalized.
• Scheduler-backed renewals: automated renewal execution with manual override, approval flows, and full attempt history.
• Activity log: a complete operational history of every subscription event.
• Storefront building blocks: cart, checkout, and customer portal guides for wiring subscriptions into your own storefront.

Reorder requires Medusa 2.3+ and installs like any other plugin. Add Copy to clipboard@reorderjs/reorder via npm and configure it in Copy to clipboardmedusa-config.ts. Because it is built on standard Medusa primitives, it works seamlessly on Medusa Cloud. Scheduled jobs, workflows, and Admin extensions run out of the box, no extra infrastructure required.

The agent setup

Reorder, like the rest of Medusa, has also been optimized for agentic development. It ships with Copy to clipboardAGENTS.md, Copy to clipboardCLAUDE.md, and an Copy to clipboard.agents/ directory, and defers to Medusa's own agentic skills wherever they fit.

The router in Copy to clipboardAGENTS.md maps each domain (subscriptions, plan-offers, renewals, dunning, cancellation, activity-log, analytics, settings) to its architecture, API, and testing docs, so an agent reads documented behavior before implementation files. Domain ownership, workflow-vs-route boundaries, and validation commands are stated explicitly, which is what keeps a plugin this wide from drifting.

Three skills in Copy to clipboard.agents/skills/:

• create-spec: anything over three steps starts as a spec in Copy to clipboard.agents/specs/, with architectural unknowns listed as numbered open questions and a hard stop until they're answered.
• run-tests: self-contained HTTP integration tests, required for changes to API contracts, workflow behavior, scheduler logic, or cross-domain transitions.
• local-dev: the publish/migrate/install sequence for syncing the plugin into a real Medusa backend.

Plus Copy to clipboard.agents/lessons.md, updated after every resolved bug.

Community contributions

Reorder joins a growing body of community tooling around Medusa. More than 1,000 community plugins are available on npm, and 100+ vetted integrations are listed in our integration directory.

We continuously do our best to surface the newest community contributions from our community, and if you want to have a look at other plugins that are being built, then stay tuned in our Discord.

Learn more or test it yourself

• Explore the product at reorderjs.com
• Follow the Quick Start guide to get running in minutes
• Browse the documentation for concepts, Admin UI walkthroughs, and API references
• Star or contribute on GitHub

Thanks to Krzysztof and Tomasz for the great contribution.