Managing subscriptions in the Admin dashboard

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)

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.

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.

Scheduling a plan change

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

1. Open the drawer

   From the detail page action menu, select Schedule plan change. The drawer loads available variants for the product.

2. Select the target variant

   Choose the variant the subscription should switch to at the next eligible renewal.

3. Set the frequency

   Set the frequency interval and value for the updated cadence.

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

5. Save

   Click Save. The pending change appears in the Pending plan change section of the detail page until the next renewal applies it.

Editing the shipping address

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

1. Open the drawer

   From the detail page action menu, select Edit shipping address. The drawer pre-fills with the current address.

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

3. Save

   Click Save. The address change is recorded in the activity log with a readable before/after diff.

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.
• 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.
cancelled	The subscription has ended. The detail page is read-only; no further actions are available.