Skip to main content
The Plans & Offers page gives you a single workspace for configuring which products and variants customers can subscribe to, what billing frequencies are available, and what discounts or trial terms apply. Navigate to Subscriptions → Plans & Offers in the Medusa Admin sidebar to get started. Each offer record can target an entire product or a single variant — when both exist, the variant-level offer takes precedence. The Effective source column lets you see at a glance which record is currently active for any given target.

​
The plans and offers list

The list shows all configured offer records in a searchable, filterable table.

​
Columns

ColumnWhat it shows
NameThe offer name you assigned
TargetThe product or variant this offer applies to
StatusWhether the offer is enabled or disabled
FrequenciesThe billing cadences configured for this offer
Effective sourceWhich record is currently winning the config resolution: Product, Variant, or Inactive
UpdatedWhen the offer was last modified
The Effective source column is particularly useful when a variant-level offer is disabled and a product-level fallback is still active, or when no active offer exists for a target at all. Use the search input in the toolbar to find offers by offer name, product title, variant title, or SKU.

​
Filters

Click Add filter to apply one or more of the following:
FilterDescription
StatusFilter by enabled or disabled
ScopeFilter by product-level or variant-level offers
FrequencyFilter by a specific billing cadence
Discount rangeFilter by discount percentage or amount
ProductSelect a product using a searchable picker
VariantSelect a variant scoped to the chosen product
The Product and Variant filters open structured picker modals instead of free-text inputs, so you always select from real catalog data. Active filters appear as chips in the toolbar. Click Clear all to remove all filters at once.

​
Sorting

Use the sorting menu to sort the list by Name, Status, Product, or Updated.

​
Row actions

Each row has an action menu with the following options:
ActionWhat it does
EditOpens the offer in an edit drawer
EnableActivates the offer (requires confirmation)
DisableDeactivates the offer (requires confirmation)
While an enable or disable mutation is in progress, the row action label updates to Enabling… or Disabling… and repeat actions on that row are blocked.

​
Creating a new offer

Click Create in the page header to open the create flow in a full-screen modal.
1

Name the offer

Enter a name that helps you identify the offer in the list — for example, “Monthly coffee subscription” or “Annual plan – Starter”.
2

Set the scope

Choose whether this offer applies to a Product or a specific Variant.
3

Select the product

Use the product picker to search for and select the target product. If the scope is Variant, a second picker lets you select the specific variant within that product.
4

Set the enabled state

Toggle Offer enabled on to make the offer active immediately after saving, or leave it off to save in draft state.
5

Configure frequencies

Add one or more billing frequencies. Each frequency row has:
  • Interval — week, month, or year
  • Value — a positive integer (for example, 1 for monthly, 3 for quarterly)
  • Discount (optional) — a percentage or fixed discount amount for customers who choose this cadence
Use Add frequency to add more rows. To remove a row, click the remove button on that row and confirm.
6

Configure rules

Expand the Rules section to set:
  • Minimum cycles — the minimum number of billing cycles before a customer can cancel
  • Trial — toggle on to enable a free trial, then set the number of trial days
  • Stacking policy — how the subscription discount interacts with other store discounts (allowed, disallow_all, or disallow_subscription_discounts)
7

Save

Click Save. The new offer appears in the list and the table refreshes automatically.
Each interval:value combination must be unique within a single offer. Duplicate frequencies are rejected before the form can be submitted.

​
Editing an existing offer

Click Edit in a row’s action menu to open the edit drawer. The drawer pre-fills all current values from the offer record.

​
What you can change

FieldEditable
NameYes
Enabled stateYes
Frequencies and discountsYes
Rules (minimum cycles, trial, stacking)Yes
Target product or variantNo
The target product and variant are read-only in the edit drawer. To retarget an offer, create a new one for the intended product or variant.
The drawer loads the offer’s current data when it opens. Changes you save are applied immediately and both the list and the drawer reflect the updated record.

​
Enabling and disabling offers

Use Enable and Disable in the row action menu to toggle an offer’s active state without editing it.
Disabling an offer prevents new subscriptions from using that configuration but does not affect subscriptions that are already active.

​
How effective config resolution works

When Reorder resolves which offer configuration applies to a product and variant — for example, during a plan change or a storefront offer lookup — it follows this order:
  1. Look for an active variant-scoped offer for the requested variant.
  2. If none exists, look for an active product-scoped offer for the product.
  3. If neither is active, the product is not subscribable.
The Effective source column in the list reflects this resolution. If a variant-level offer is disabled and a product-level offer is active, the column shows Product. If no active offer exists for the target context, it shows Inactive.