> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://supr-bundles-and-subscriptions.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Tag Settings

| To access this settings page, go to [**Supr Bundles & Subscriptions > Settings > Tags**](https://admin.shopify.com/apps/super-subscriptions/app/settings/tags)

The app can tag your Shopify customers and orders by subscription status, for example **has active subscription** on a customer or **recurring order** on a renewal order. Use these tags to filter customers and orders in Shopify, build customer segments, and target subscribers in email marketing tools such as Shopify Email or Klaviyo.

### Table of contents

* [How subscription tags work](#3-how-subscription-tags-work)
* [Customer tags](#3-customer-tags)
* [Order tags](#3-order-tags)
* [Changing the tag text](#3-changing-the-tag-text)
* [Using tags to email or segment subscribers](#3-using-tags-to-email-or-segment-subscribers)
* [Common questions](#3-common-questions)
* [Related guides](#3-related-guides)

### How subscription tags work

**Every tag is off until you tick it.** Tick the tags you want, click **Save** in the save bar, and confirm with **Update tags**.

When you save, the app updates the tags on your existing subscription customers and orders straight away, so you do not have to wait for new orders. Allow a few minutes for all tags to update. Turning a tag off, or changing its text, removes the old tag in the same way.

After that the tags stay up to date by themselves: they are added and removed as subscriptions start, renew, pause, get cancelled or fail.

### Customer tags

|| Use these tags to identify customers based on their subscription status.

| Setting | Tag added (default text) | Added to customers who have |
| --- | --- | --- |
| **Has subscription contract** | has subscription contract | any subscription, in any status |
| **Has active subscription** | has active subscription | at least 1 active subscription |
| **Has paused subscription** | has paused subscription | at least 1 paused subscription |
| **Has cancelled subscription** | has cancelled subscription | at least 1 cancelled subscription |
| **Has completed subscription** | has completed subscription | at least 1 completed subscription (one that reached its end) |
| **Has failed subscription** | has failed subscription | at least 1 failed subscription (for example when payment fails) |

A customer can carry several of these at once, for example one active and one cancelled subscription.

### Order tags

Tags applied to orders based on their role in a subscription:

| Setting | Tag added (default text) | Added to |
| --- | --- | --- |
| **Subscription order** | subscription order | every order that is part of a subscription |
| **Subscription order number** | subscription order #1, #2, #3... | every subscription order, counting the first order as #1 |
| **Initial order** | initial subscription order | the first order of a subscription |
| **Recurring order** | recurring order | every renewal order |
| **Subscription renewal number** | subscription renewal #1, #2, #3... | renewal orders only, counting the first renewal as #1 (the first order is not included) |

There is no tag with the subscription's ID. To match orders to subscriptions from another system, use the [API](/en-us/article/using-the-api-129ae4j/).

### Changing the tag text

Click the pencil button under a tag to open **Edit tag**, type the new text and click **Edit**. The two number tags must keep their number placeholder (`{ contract_order_number }` or `{ contract_renewal_number }`), which the app replaces with the order's number.

|| Other guides and your own segments may rely on the default text. [How to Offer a One-Time Use Subscription Discount](/en-us/article/how-to-offer-a-one-time-use-subscription-discount-plg0ph/), for example, uses **has subscription contract**. If you rename a tag, update any segment that uses it.

### Using tags to email or segment subscribers

The app does not send marketing or bulk emails itself. Instead, tag your subscribers and use the tags in your email tool:

1. Turn on the customer tags you need, for example **Has active subscription** and **Has paused subscription**, then save and confirm with **Update tags**.
2. In your Shopify admin, go to **Customers > Segments** and create a segment where the customer tags contain the tag, for example `has paused subscription`.
3. Send to that segment from Shopify Email, or use the tag in your marketing app. Apps that sync Shopify customer tags, such as Klaviyo, can build lists or segments from them.

A few examples:

* **Win back paused or cancelled subscribers**: a segment on **has paused subscription** or **has cancelled subscription**.
* **Upsell one-time buyers**: customers **without** **has subscription contract** have never subscribed.
* **Tell first orders from renewals** in reports or in apps that read order tags (for example affiliate or fulfilment apps): use **Initial order**, **Recurring order** and the number tags.

Subscription tags are separate from your newsletter list: a subscriber has not necessarily agreed to marketing emails, so respect each customer's email marketing consent.

### Common questions

* **Why don't my renewal orders have a subscription tag?**
  Order tags are off until you turn them on here. Tick **Subscription order** or **Recurring order**, click **Save** and confirm with **Update tags**. Existing subscription orders are tagged too.
* **How do I email only customers with an active subscription?**
  Turn on **Has active subscription**, then build a segment on the `has active subscription` tag in **Customers > Segments** or in your email app.
* **How do I build a segment of paused (or cancelled, or failed) subscribers?**
  Turn on the matching customer tag and create a Shopify segment where the customer tags contain it. The tag is removed automatically when the customer no longer has a subscription in that status.
* **Can my affiliate or referral app tell a first order from a renewal?**
  Yes, if it can read order tags: turn on **Initial order**, **Recurring order**, **Subscription order number** or **Subscription renewal number**. Other apps cannot read the subscription itself, because Shopify only shares it with the app that created it. See [Using the API](/en-us/article/using-the-api-129ae4j/) for linking orders to subscriptions from your own systems.
* **Do tags apply to customers who subscribed before I turned them on?**
  Yes. Saving the setting updates your existing subscription customers and orders within a few minutes.

### Related guides

* [How to Offer a One-Time Use Subscription Discount](/en-us/article/how-to-offer-a-one-time-use-subscription-discount-plg0ph/), which uses the **Has subscription contract** tag to build a new-subscriber-only segment.
* [Subscription Analytics](/en-us/article/subscription-analytics-1fn3ntr/)
* [Using Supr Bundles & Subscriptions with other apps and tools](https://supr-bundles-and-subscriptions.crisp.help/en-us/article/using-the-app-with-other-apps-1ve2ecs/)