> 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/admin/how-to-apply-a-discount-code-to-subscription-products.md).

# How to apply a discount code to Subscription Products?

Use Shopify discount codes on subscription products at checkout, and add discounts to subscriptions that already exist.

Besides the discount you set in a selling plan, you can give subscribers extra discounts with Shopify discount codes. A code can apply at checkout, on later renewals, or both. You can also add a discount to a subscription that already exists, and customers can enter codes themselves in the customer portal.

## Ways to discount a subscription

| Discount                                 | Where you set it                                                                                                                                                                  | When it applies                                            |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| **Selling plan discount**                | In the selling plan, under **Offer Incentives**. See [Create a selling plan](https://subscriptions-docs.tech-arms.io/features/subscription/how-to-create-a-subscription-plan.md). | Automatically, to everyone who subscribes with that plan.  |
| **Discount code at checkout**            | In **Discounts** in Shopify admin. Customers enter the code at checkout.                                                                                                          | On the first order, and on as many renewals as you choose. |
| **Discount on an existing subscription** | On the subscription in the app.                                                                                                                                                   | On the next renewals of that subscription only.            |
| **Code entered in the customer portal**  | Customers enter a Shopify discount code on their subscription.                                                                                                                    | On the next renewals of that subscription.                 |

## Create a discount code for subscriptions

You create discount codes in Shopify admin, not in the app.

{% stepper %}
{% step %}

### Create the discount in Shopify

In Shopify admin, go to **Discounts** and click **Create discount**. Choose the discount type, for example **Amount off products**, and choose **Discount code** as the method. Enter the code and the value.
{% endstep %}

{% step %}

### Allow it on subscriptions

Under **Purchase type**, choose **Subscription** or **Both**. If you choose **One-time purchase**, the code doesn't work on subscription items.
{% endstep %}

{% step %}

### Choose how many payments it covers

Under **Recurring payments for subscriptions**, choose whether the discount applies to the first payment only, to a set number of payments, or to all recurring payments.

![The purchase type and recurring payments options on a Shopify discount code](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FteQtehO9pfgigWrseR7F%2Fshopify-discount-subscription-options.png?alt=media)
{% endstep %}

{% step %}

### Save and test

Save the discount. Add a subscription product to the cart, check out with the code, and check the discount on the new subscription in the app.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Shopify checks a code's conditions, such as eligible customers and usage limits, only when the code is first applied. After that, the code keeps applying to renewals until it reaches the number of payments you chose.
{% endhint %}

## Add a discount to an existing subscription

In the app menu, click **Subscriptions** and open the subscription. In the **Discounts** card, you can:

* **Apply a discount code:** enter a Shopify discount code in **Apply Discount Code** and click **Apply**. Automatic discounts can't be applied this way.
* **Create a manual discount:** click **Create**. A manual discount applies to this subscription only. Fill in the fields below and click **Create**.

| Field                     | What it does                                                                                                                                       |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Title discount**        | The discount name, shown in the **Discounts** card.                                                                                                |
| **Value**                 | The discount amount.                                                                                                                               |
| **Discount Type**         | **Percentage** or **Amount**.                                                                                                                      |
| **Apply to**              | Only for **Amount**. **Subscription contract.** takes the amount off the whole order. **Subscription line items.** takes it off each product line. |
| **Recurring Cycle Limit** | The number of orders the discount applies to. Leave it empty to apply it to every order.                                                           |

![The Discounts card on a subscription with Apply Discount Code and Create highlighted](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FJ7XZIQBmjcF6bowQUKEc%2Fcontract-discounts-card.png?alt=media)

To change a manual discount, click its pencil icon. Discount codes can't be edited, only removed. To remove any discount, click its trash icon and confirm.

See [Contract details](https://subscriptions-docs.tech-arms.io/features/subscriptions/contract-details.md) for the rest of the subscription page.

## Let customers apply codes in the portal

In the [Customer Portal](https://subscriptions-docs.tech-arms.io/features/customer-portal.md), customers open their subscription and enter a Shopify discount code under **Discounts**, then click **Apply**. The code must allow subscriptions, as described above.

{% hint style="warning" %}
Customers can also remove discounts from their subscription in the portal, including discounts you added. There is no setting to turn this off.
{% endhint %}

## Good to know

* Discounts on an existing subscription apply to future renewals. They don't change orders already placed.
* Shopify reapplies discounts when products in a subscription are added, changed, or removed.
* The app uses a Shopify automatic discount named **TA SUBSCRIPTIONS APP SELLING PLAN DISCOUNT** (on older stores: **EASTO SELLING PLAN DISCOUNT**) for Try Before You Buy and Free Gift. Don't turn it off in Shopify **Discounts**, or those features stop discounting.
* To tell customers about a code, add it to the widget text. See [Widgets](https://subscriptions-docs.tech-arms.io/features/customization.md).

*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/admin/how-to-apply-a-discount-code-to-subscription-products.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.
