> ## 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.

# Subscriptions

> Browse, filter, and act on subscriptions from the dedicated Subscriptions page, and manage lifecycle actions directly from each subscription's detail view.

The Subscriptions page at `/app/subscriptions` is your main workspace for managing recurring customers. From here you can find any subscription by searching or filtering, inspect its full detail, and trigger lifecycle actions like pause, resume, or cancel. The same plugin also adds a subscription widget to standard Medusa order detail pages, so you can always navigate from an order to the linked subscription without leaving context.

## The subscriptions list

Navigate to **Subscriptions** in the Medusa Admin sidebar to open the list. The table shows one row per subscription and is built with Medusa's standard `DataTable`, so it behaves consistently with other Admin list pages.

### Columns

| Column           | What it shows                                                   |
| ---------------- | --------------------------------------------------------------- |
| **Reference**    | Human-readable subscription identifier (for example, `SUB-001`) |
| **Product**      | Product and variant name                                        |
| **Status**       | Current lifecycle state with a status badge                     |
| **Frequency**    | Billing cadence (for example, every month)                      |
| **Next renewal** | The projected next renewal date                                 |

### Search

Use the search input in the top-right of the toolbar to find subscriptions by subscription reference, customer name, customer email, product title, variant title, or SKU.

### Filters

Click **Add filter** to apply one or more of the following filters:

| Filter              | Description                                              |
| ------------------- | -------------------------------------------------------- |
| **Status**          | Filter by `active`, `paused`, `past_due`, or `cancelled` |
| **Trial**           | Show only subscriptions currently in a trial period      |
| **Skip next cycle** | Show only subscriptions with the next delivery skipped   |
| **Next renewal**    | Filter by a scheduled renewal date range                 |

Active filters appear as chips in the toolbar. Remove them individually or click **Clear all** to reset.

### Sorting

Use the sorting menu in the toolbar to sort by **Status**, **Product**, or **Next renewal**.

### Row actions

Each row has an action menu with quick lifecycle actions. Available actions depend on the subscription's current status:

| Status      | Available actions    |
| ----------- | -------------------- |
| `active`    | Pause, Cancel        |
| `paused`    | Resume, Cancel       |
| `cancelled` | No actions available |

Click anywhere on a row to open that subscription's detail page.

## Subscription detail

The detail page at `/app/subscriptions/:id` is the main operational screen for a single subscription. It shows the subscription reference, status badge, and a header action menu on the right.

### Information sections

The detail page is organized into the following sections:

* **Subscription** — billing frequency, dates, and skip status
* **Customer** — linked customer record
* **Product** — the subscribed variant, with a link to the variant detail page and SKU visible as a helper field
* **Shipping address** — the address snapshot used for this subscription's deliveries
* **Pending plan change** — any scheduled update to the plan or cadence that will apply at the next eligible renewal
* **Activity log** — a per-subscription event timeline (see [Viewing the subscription activity log](/admin/activity-log))

### Detail actions

Open the action menu in the top-right of the detail page to access the following:

| Action                    | When it's available                               |
| ------------------------- | ------------------------------------------------- |
| **Pause**                 | Subscription is `active`                          |
| **Resume**                | Subscription is `paused`                          |
| **Schedule plan change**  | Subscription is `active` or `paused`              |
| **Edit shipping address** | Subscription is `active` or `paused`              |
| **Cancel**                | Subscription is `active`, `paused`, or `past_due` |

Destructive actions require confirmation before the change is applied. Actions are disabled while a mutation is in progress.

<Note>
  **Schedule plan change** is only available on the detail page, not in the list row menu. Because it opens a form that requires context about the current plan, it follows the Medusa pattern of keeping form-based edits in detail views.
</Note>

### Scheduling a plan change

Use **Schedule plan change** to queue a future update to the subscribed variant or billing cadence.

<Steps>
  <Step title="Open the drawer">
    From the detail page action menu, select **Schedule plan change**. The drawer loads available variants for the product.
  </Step>

  <Step title="Select the target variant">
    Choose the variant the subscription should switch to at the next eligible renewal.
  </Step>

  <Step title="Set the frequency">
    Set the frequency interval and value for the updated cadence.
  </Step>

  <Step title="Set when the change takes effect">
    Choose an effective date if you want the change to apply at a specific renewal rather than the next one.
  </Step>

  <Step title="Save">
    Click **Save**. The pending change appears in the **Pending plan change** section of the detail page until the next renewal applies it.
  </Step>
</Steps>

### Editing the shipping address

Use **Edit shipping address** to update the address snapshot used for this subscription's deliveries.

<Steps>
  <Step title="Open the drawer">
    From the detail page action menu, select **Edit shipping address**. The drawer pre-fills with the current address.
  </Step>

  <Step title="Update address fields">
    Edit any of the available fields: first name, last name, company, address line 1, address line 2, city, postal code, province/state, country, and phone.
  </Step>

  <Step title="Save">
    Click **Save**. The address change is recorded in the activity log with a readable before/after diff.
  </Step>
</Steps>

## The subscription widget on order detail pages

The Reorder plugin extends the standard Medusa **Order detail** page with a **Subscription** widget. The widget shows:

* A linked subscription card when the order is associated with a subscription, with a direct link to the subscription detail page.
* The current subscription discount label derived from the subscription's `pricing_snapshot`.
* The projected next renewal date for the linked subscription.
* A **One-time order** label when the order has no subscription link.

This lets you move from any subscription-generated order to its parent subscription without navigating away from the order context.

## Status reference

| Status      | What it means for operators                                                                   |
| ----------- | --------------------------------------------------------------------------------------------- |
| `active`    | Billing is running normally. Pause, cancel, or schedule changes are available.                |
| `paused`    | Billing is on hold. Resume or cancel to change state.                                         |
| `past_due`  | A renewal payment failed and dunning is active. See [Managing dunning cases](/admin/dunning). |
| `cancelled` | The subscription has ended. The detail page is read-only; no further actions are available.   |