> For the complete documentation index, see [llms.txt](https://subscriptions-docs.tech-arms.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://subscriptions-docs.tech-arms.io/features/subscription/how-to-create-a-subscription-plan.md).

# Create a selling plan

Create a selling plan, choose the products it applies to, and set up delivery frequency, discounts, and advanced rules for each plan option.

A **selling plan** is a subscription offer you attach to products. Customers see it in the subscription widget on the product page and choose one of its **plan options**, such as "Delivered every week" or "Delivered every month".

Each selling plan contains:

* a name shown to customers,
* the products or variants it applies to,
* 1 to 20 plan options, each with its own delivery frequency and discount,
* optional rules for who can see the plan and when.

{% hint style="info" %}
This page covers **Subscribe & save** plans. To let customers build their own bundle, see [Build-A-Box](https://subscriptions-docs.tech-arms.io/features/build-a-box.md).
{% endhint %}

## Before you start

* Activate the app and enable the App Embed in your theme. See [Activate TA Subscriptions App](https://subscriptions-docs.tech-arms.io/getting-started/how-to-install-or-uninstall-our-subscription-app.md).
* Decide which products you want to sell as a subscription. You pick products or variants one by one. Selecting a whole collection or a product tag is not supported, and products you add to a collection later are not added to the plan automatically.

## Create the plan

{% stepper %}
{% step %}

### Open Selling Plans

In the app menu, click **Selling Plans**, then click **Create Selling Plan**.

![The Selling Plans list with the Create Selling Plan button highlighted](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FEP57tgsuX2909w5zNWKy%2Fselling-plans-list.png?alt=media)
{% endstep %}

{% step %}

### Name the plan and choose products

In **Selling Plan Name**, enter the name customers will see on the product page, for example "Subscribe and save". If you leave the field empty, the app uses "Subscribe and save".

In **Apply To**, choose the **Products** tab to add whole products or the **Variants** tab to add specific variants. Search for an item or click **Browse**, tick the items you want, and click **Select**.

![Selling Plan Name and Apply To cards, with the Products and Variants tabs and the Browse button highlighted](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FFIv0yR2VDFx4smEb9dHm%2Fselling-plan-name-apply-to.png?alt=media)

A product can belong to more than one selling plan. The widget shows every plan that applies to it.
{% endstep %}

{% step %}

### Set up the first plan option

Every new plan starts with one option in **Selling Plan Options**. Fill in:

| Field                  | What it does                                                                                                                           |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Option Name**        | The option's name on your storefront. If empty, the app names it after the frequency, for example "Delivered every week".              |
| **Delivery Frequency** | How often an order is created and delivered: a number from 1 to 99 and a unit (**Day(s)**, **Week(s)**, **Month(s)**, or **Year(s)**). |
| **Label**              | The short text in the plan selector on the product page, for example "1 week".                                                         |

![A plan option with Option Name, Delivery Frequency and Label](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FJlyVGgGGBYHAIGsBK4kf%2Fplan-option-basics.png?alt=media)

{% hint style="warning" %}
Changing **Delivery Frequency** replaces the **Label** with a default such as "2 weeks". Set the frequency first, then edit the label.
{% endhint %}
{% endstep %}

{% step %}

### Add a discount (optional)

Under **Offer Incentives**:

* Turn on **Discount applied from the first order** and choose **Percentage Off (%)**, **Amount Off**, or **Set a fixed price**. This discount applies to the first order and to every renewal after it.
* To change the discount later in the subscription, turn on **Discount adjustment after a number of orders**, enter a number in **after order**, and set the new discount. You can add one adjustment per plan option.

The **after order** number counts completed orders, starting with the order placed at checkout. With **after order 1**, the first order uses the first discount and the adjusted discount applies from the second order, which is the first renewal. With **after order 3**, the adjusted discount applies from the fourth order.

**Example:** 30% off the first order, then 10% off every renewal. Turn on **Discount applied from the first order** with 30%, then turn on **Discount adjustment after a number of orders** with **after order 1** and 10%.

![Offer Incentives with 30% off the first order and 10% off after order 1](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FVfXLIXwhYs0I17Ymgqbp%2Fplan-option-incentives.png?alt=media)
{% endstep %}

{% step %}

### Add more plan options (optional)

Click **Add** at the top of **Selling Plan Options** to offer another frequency or discount. Drag an option by its handle to reorder it. A plan needs at least one option and can have up to 20.
{% endstep %}

{% step %}

### Save and activate

Click **Save** in the bar at the top of the page. After the plan is saved, use **Activate** or **Deactivate** in the top-right corner to control whether the plan shows in the widget. The badge next to the page title shows **Active** or **Draft**.

![The top bar with the Save button and the Activate/Deactivate button highlighted](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2F2mrgGW3XMbfkC83stCDf%2Fplan-top-bar.png?alt=media)

**Activate** and **Deactivate** are available only when there are no unsaved changes. To check the result, click the **View on store** icon above the preview. It opens the first selected product on your storefront.
{% endstep %}
{% endstepper %}

## Advanced settings for a plan option

In a plan option, click **Change** next to **Advanced Setting**. Make your changes, click **Done**, then **Save** the page. Closing the window or clicking **Cancel** discards the changes.

![The Advanced settings window of a plan option](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FSSk06vuugIThpK7zXVFP%2Fplan-option-advanced-settings.png?alt=media)

### Subscription length

| Field                      | What it does                                                                                                                                        |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Minimum billing cycles** | The number of billing cycles a customer must complete before they can cancel in the customer portal. Leave it at 0 to let customers cancel anytime. |
| **Maximum billing cycles** | The number of billing cycles after which the subscription expires. Leave it empty for a subscription that never expires.                            |

Both fields count **billing cycles**, not deliveries. On a regular plan, one billing cycle is one delivery. On a prepaid plan, one billing cycle covers all the prepaid deliveries. The minimum cannot be greater than the maximum.

### Delivery schedule

| Field              | What it does                                                                                                                                                                                          |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Delivery day**   | **Same day as initial order**, a day of the week, or a day of the month. Not available when the frequency unit is **Day(s)**.                                                                         |
| **First delivery** | When the first delivery is scheduled. **On checkout** schedules it right after checkout. **On delivery day** schedules it on the nearest delivery day. Shown when you choose a specific delivery day. |
| **Cutoff window**  | **Disabled**, or 1 to 364 days. Skips the first delivery when the customer orders too close to the nearest delivery day. Shown when you choose a specific delivery day.                               |

How **Cutoff window** works with **First delivery**, for an order placed at checkout:

| First delivery      | Ordered at least the cutoff number of days before the delivery day | Ordered closer to the delivery day            |
| ------------------- | ------------------------------------------------------------------ | --------------------------------------------- |
| **On checkout**     | Delivered right away                                               | First delivery is on the delivery day         |
| **On delivery day** | Delivered on the delivery day                                      | First delivery moves to the next delivery day |

**Example:** the delivery day is the 1st of each month, **First delivery** is **On delivery day**, and **Cutoff window** is 5 days. A customer who orders on the 20th gets the first delivery on the 1st of next month. A customer who orders on the 28th is inside the cutoff window, so the first delivery moves to the 1st of the month after.

### Prepaid plan

Turn on **Prepaid plan** to charge customers once for several deliveries. In **Number of prepaid deliveries**, choose from 2 to 51. The plan renews when the prepaid deliveries are used up.

**Example: a 3-month prepaid plan that ends after 3 months.** Set **Delivery Frequency** to 1 **Month(s)**, turn on **Prepaid plan** with 3 prepaid deliveries, and set **Maximum billing cycles** to 1. One billing cycle covers all three deliveries. Setting it to 3 would run the subscription for 9 months.

### Try Before You Buy

Turn on **Try Before You Buy** to discount the first order and delay the next charge until the trial ends. See [Try Before You Buy](https://subscriptions-docs.tech-arms.io/features/subscription/try-before-you-buy.md).

## Control who sees the plan and when

At the bottom of the page, click **Edit** in the **Advanced settings** card.

* **Customer condition**
  * **Visible to**: all customers, logged-in customers, not-logged-in customers, specific customers, or customers with certain tags.
  * **Not Visible to**: specific customers or customers with certain tags.
* **Duration Settings**: turn on **Start Date** and **End Date** to show the plan only during a period. The start date must be before the end date.

![The Advanced settings card with Customer condition and Duration Settings](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FkaILpjwIley5xZYD0Jnq%2Fselling-plan-visibility.png?alt=media)

{% hint style="warning" %}
These settings, and the **Draft** status, hide the plan in the app's subscription widget. They do not block the plan at checkout. The plan stays attached to the product in Shopify, so other entry points, such as a theme's built-in plan selector or Shopify POS, can still sell it.
{% endhint %}

## Manage your selling plans

The **Selling Plans** list shows each plan's name, status, type, position, and creation date. From the list you can:

* filter plans by product ID or variant ID,
* edit a plan,
* **Duplicate** a plan. The copy keeps the same products and status, so deactivate or edit it before customers see two identical plans,
* **Delete** a plan.

Editing or deleting a selling plan does not change existing subscriptions. Customers who already subscribed keep the terms they signed up with. Changes apply to new subscriptions only.

## Good to know

* After saving, reload the page and check that the number in **Products (N selected)** is what you expect. If it dropped, or the plan does not show in the widget, save the plan again.
* Keep the automatic discount **TA SUBSCRIPTIONS APP SELLING PLAN DISCOUNT** (on older stores: **EASTO SELLING PLAN DISCOUNT**) active in **Shopify admin > Discounts**. Try Before You Buy and Free Gift discounts depend on it.

*If you need help, feel free to reach out to us via in-app* [***Live chat***](https://go.crisp.chat/chat/embed/?website_id=c4ae10a3-f762-4968-b35a-c931caf62a96)***,*** [***Book a call***](https://calendly.com/ta-subscription-app-support/30min) *or at* [***support@tech-arms.io***](mailto:support@tech-arms.io)***.***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://subscriptions-docs.tech-arms.io/features/subscription/how-to-create-a-subscription-plan.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
