---
title: "Reorder: Open-Source Subscriptions Plugin for Medusa"
description: "Discover Reorder, the open-source MIT-licensed subscription plugin for Medusa. Get lifecycle management, admin UI, dunning flows, and analytics built in — with no revenue cut."
url: https://medusajs.com/blog/reorder
last_updated: 2026-08-13T15:38:19Z
---

# Reorder: Open-Source Subscriptions Plugin for Medusa

_Published 2026-07-28 by Nicklas Gellner in Ecosystem_

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](https://www.reorderjs.com) 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.](https://docs.reorderjs.com)

## 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 `@reorderjs/reorder` via npm and configure it in `medusa-config.ts`. Because it is built on standard Medusa primitives, it works seamlessly on [Medusa Cloud](https://cloud.medusajs.com/). Scheduled jobs, workflows, and Admin extensions run out of the box, no extra infrastructure required.

## The agent setup

Reorder, [like the rest of Medusa](https://docs.medusajs.com/learn/introduction/build-with-llms-ai), has also been optimized for agentic development. It ships with `AGENTS.md`, `CLAUDE.md`, and an `.agents/` directory, and defers to Medusa's own agentic skills wherever they fit.

The router in `AGENTS.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 `.agents/skills/`:

- **create-spec**: anything over three steps starts as a spec in `.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 `.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](https://medusajs.com/integrations).

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](https://discord.gg/medusajs).

## Learn more or test it yourself

- Explore the product at [reorderjs.com](https://www.reorderjs.com)
- Follow the [Quick Start guide](https://docs.reorderjs.com/quickstart) to get running in minutes
- Browse the [documentation](https://docs.reorderjs.com) for concepts, Admin UI walkthroughs, and API references
- Star or contribute on [GitHub](https://github.com/reorder-js/reorder)

Thanks to Krzysztof and Tomasz for the great contribution.