A plan version’s visibility is its status. Every version is either a draft or active. Active versions are offered to merchants. A draft is visible only to a store already subscribed to it.
The lifecycle
Build and edit a plan as a draft for as long as you like. See Create a plan. Activating it is the step that makes it real: merchants can then subscribe, and Shopify hears about the plan when they do.
Switching an active plan back to draft hides it from new subscribers. Merchants already on it keep their subscription and their entitlements: Shopify holds the subscription, and retiring your shop window doesn’t cancel it. That makes draft the safe way to withdraw a plan: you stop selling it without touching anyone who bought it.
Deleting a plan is different from hiding it, and the Plan Builder says so before you do it.
Subscriber protections
The same protections apply to draft and active versions. A version with live non-test subscribers is locked, because Shopify’s Billing API keeps charging the recurring terms the merchant approved. Live subscriptions are active, accepted, frozen, scheduled to start at the end of a paid period, or pending for less than 48 hours. A store moving to a free plan at the end of its paid period counts toward that free plan as well. Test subscriptions on development stores do not lock a version.
On the latest version, all fields stay editable. Names, descriptions, trial days and status can be saved in place. Adding features, raising numeric limits or included usage, lowering the effective usage rate, and removing usage terms benefit that version’s subscribers immediately. Changing a usage cap is also allowed in place but applies only to new subscriptions.
Changing either recurring price, removing features, lowering limits or included usage, adding any usage term, switching its subject, or raising its effective rate needs a new version. This includes unpriced event or view allowances: an overage rate of 0 does not make a new allowance or a lower included quantity safe to apply in place. See Editing a plan with subscribers for the field-by-field rules.
Edit the latest version and select Save. If a new version is needed, the Save as version 2? dialog lists the changes and the stores that will stay on version 1. Confirm with Save as version 2 to open the new version’s page. The number advances from the latest version. The new version inherits the previous version’s stored status: an active version gives an active new version and switches the previous one to draft, while a draft gives another draft. Discount codes restricted to the previous version automatically cover the new one too. Existing subscribers keep their previous version and approved recurring price. They do not move automatically.
An older version links to the latest with Open version 2, for example. Its protected fields remain disabled or bounded while it has live subscribers. Start from the latest to save a new version. More actions → Duplicate on the plan’s page instead creates a different draft plan, starting at version 1 without copied discount codes. It picks the next available name: Pro (copy), Pro (copy 2), Pro (copy 3), and so on.
What merchants see on the pricing page
Active plans are rendered by the SDK from the plan definition: name, price, trial, the features included, and any metered events or views with their usage terms. Prices are shown in the merchant’s own currency, converted from your configured amounts at subscribe time.
A merchant whose current plan is a draft still sees its card as Current plan, with a No longer offered badge and a disabled button. Other stores never see that draft and cannot subscribe to it. The active offers still show Upgrade or Downgrade relative to the merchant’s current plan, even when it is no longer offered.
A downgrade or a cancellation keeps the merchant on their plan until the end of the period they have paid for. Until then the pricing page shows the date and a Keep button. See Plan changes.
On Shopify’s approval screen, usage terms state the rate per block of the event’s unit, any positive included quantity and the monthly cap. A view or an event without a unit uses “unit” or “units”. See What the merchant approves for examples.
Working out what’s live
The plans list has one row per plan, using its latest version, with status, subscriber count, monthly and annual price. A badge such as v2 identifies the version, and 3 stores on earlier versions appears when older versions still have live subscribers. Older versions do not have their own rows.
Open the plan’s Versions section to see each version’s status, monthly price and live subscribers, and to follow its link. An older version with no live non-test subscribers can be deleted there if your role allows it. See Find and manage versions.
The list also shows active and draft counts, MRR and average revenue per subscriber. Subscriber counts and revenue metrics exclude test subscriptions. A store with a scheduled downgrade or cancellation counts on its current plan until the date the change takes effect. Last modified on November 10, 2026