> ## Documentation Index
> Fetch the complete documentation index at: https://help.the-meridian.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> These are the public docs of Meridian for Shopify apps: hosting, billing (Plan Builder and the @the-meridian/sdk package), CRM, emails and automations for Shopify app developers.
> Start with these pages: Meridian MCP (https://help.the-meridian.ai/mcp-server.md) to connect a coding agent, AI coding agents (https://help.the-meridian.ai/ai-agents.md) for the agent skill, SDK quickstart (https://help.the-meridian.ai/sdk-quickstart.md), Running your app with the CLI (https://help.the-meridian.ai/cli-dev.md), Deployment (https://help.the-meridian.ai/deployment.md), and Errors (https://help.the-meridian.ai/errors.md) to look up an error code or message.
> Fetch one page at a time as Markdown (the page URL followed by .md), using the index in https://help.the-meridian.ai/llms.txt. llms-full.txt holds every page in one file of about 900 KB, so avoid loading it whole.
> With Meridian MCP connected, search these docs with docs_search and docs_get, and read live facts (feature and event keys, plan ids, environments, deployments, logs) from the MCP tools instead of guessing them.

# Plan visibility: draft and active plans

> Draft versus active plan status, what merchants see on the pricing page, and the subscriber protections that lock a plan or require saving a new version.

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.

| Status | Editable | On the pricing page | Subscribable |
| - | - | - | - |
| **Draft** | Subject to subscriber protections | Only as the subscriber's current plan | No |
| **Active** | Subject to subscriber protections | Yes | Yes |

## The lifecycle

Build and edit a plan as a draft for as long as you like. See [Create a plan](https://help.the-meridian.ai/create-a-plan.md). [Activating it](https://help.the-meridian.ai/publishing-plans.md) 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](https://help.the-meridian.ai/create-a-plan.md#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](https://help.the-meridian.ai/plans.md) from the plan definition: name, price, trial, the [features](https://help.the-meridian.ai/plan-features.md) included, and any metered [events](https://help.the-meridian.ai/usage-events.md) or [views](https://help.the-meridian.ai/usage-views.md) 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 {plan}** button. See [Plan changes](https://help.the-meridian.ai/plan-changes.md).

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](https://help.the-meridian.ai/create-a-plan.md#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](https://help.the-meridian.ai/create-a-plan.md#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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.