> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reorderjs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuring the Reorder plugin in Medusa

> Install @reorderjs/reorder and add it to medusa-config.ts to enable Admin UI, Store API routes, and scheduled jobs in your Medusa store.

Reorder is installed as a standard Medusa plugin. Adding it to your project registers Admin UI extensions, Admin and Store API routes, and the scheduled jobs that power renewals, dunning, and analytics — no separate server required.

## Install the package

Add `@reorderjs/reorder` to your Medusa project using npm or yarn.

<CodeGroup>
  ```bash npm theme={null}
  npm install @reorderjs/reorder
  ```

  ```bash yarn theme={null}
  yarn add @reorderjs/reorder
  ```
</CodeGroup>

## Add the plugin to medusa-config.ts

Open your `medusa-config.ts` file and add Reorder to the `plugins` array.

```ts medusa-config.ts theme={null}
plugins: [
  // other plugins
  {
    resolve: "@reorderjs/reorder",
    options: {},
  },
]
```

<Note>
  The `options` object is required but empty for the current release. No configuration values are needed to get the plugin running.
</Note>

## Start Medusa

Run your normal Medusa startup command. Reorder registers all of its components on boot.

```bash theme={null}
yarn dev
```

## Local development with a checked-out Reorder repo

If you are developing Reorder locally and want a Medusa backend to use your local checkout instead of the published package, point the backend dependency to the local filesystem copy.

```json package.json theme={null}
{
  "dependencies": {
    "@reorderjs/reorder": "file:../reorder"
  }
}
```

After adding or updating that dependency, run:

```bash theme={null}
yarn install
```

### Refreshing the local plugin version in a Medusa backend

When you change code in your local `reorder` repository, use this sequence so the Medusa backend picks up the newest build and migrations:

1. In the `reorder` repository, run `yarn medusa plugin:publish`
2. In the Medusa backend, run `yarn medusa db:migrate`
3. In the Medusa backend, run `yarn install`

<Warning>
  Do not assume your Medusa backend is using the newest local plugin code until that sequence has completed.
</Warning>

## What gets added to your store

Once the plugin is loaded, Medusa boots with the following additions from Reorder:

| Component            | What it provides                                                                                                                                                                   |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Admin UI routes**  | Dedicated pages for Subscriptions, Plans & Offers, Renewals, Dunning, Cancellations, Activity Log, Analytics, and Subscription Settings — accessible from the Medusa Admin sidebar |
| **Admin API routes** | Protected REST endpoints under `/admin/` for all subscription operations, settings, and analytics queries                                                                          |
| **Store API routes** | Customer-facing endpoints under `/store/` for subscription checkout and offer resolution                                                                                           |
| **Scheduled jobs**   | Renewal execution, dunning retry scheduling, and analytics roll-up jobs that run on configurable cadences                                                                          |

<Tip>
  After starting Medusa, open the Admin dashboard and look for the **Subscriptions** entry in the sidebar to confirm the plugin loaded correctly.
</Tip>

## Next steps

* [Subscription settings](/configuration/subscription-settings) — configure global defaults for trials, dunning, renewals, and cancellations
* [Plans & Offers](/admin/plans-offers) — create your first subscription plan and attach it to a product
* [Requirements](/requirements) — verify Node.js and Medusa version compatibility before installing