> 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/email-notifications/auto-tag.md).

# Auto Tag

Automatically tag renewal orders and customers in Shopify based on their subscription status.

**Auto Tag** adds Shopify tags to subscription orders and customers for you. Use the tags to filter orders, build customer segments, or trigger workflows in Shopify Flow and other connected tools, without tagging anything by hand.

There are three tag rules:

* **Recurring Order** tags renewal orders.
* **Active Customer** tags customers who have at least one active subscription.
* **Payment Failure Customer** tags customers whose subscription has a failed payment.

All three rules are off until you turn them on. The app does not add any tag before that.

## Set up Auto Tag

{% stepper %}
{% step %}

### Open Auto Tag

In the app menu, click **Settings**, then click the **Automation** card. In the window that opens, click **Auto Tag**.

![The Automation window with the Auto Tag card highlighted](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FbDKhchgsbA2yfx735glh%2Fsettings-automation-popup.png?alt=media)
{% endstep %}

{% step %}

### Turn on the rules you need

The page has two cards: **Order Tags** and **Customer Tags**. Turn on the switch next to each rule you want to use.

![The Auto Tag page with the Order Tags and Customer Tags cards and their switches highlighted](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FJHC8bQOmO4zGWCTrzlqc%2Fauto-tag-page.png?alt=media)
{% endstep %}

{% step %}

### Change the tag name (optional)

Each rule has one field with its tag name. Edit the text to use your own tag. The tag under the field shows how it will look in Shopify.

Each rule adds **one** tag. Entering a comma does not split the text into several tags; the whole text is used as a single tag.

{% hint style="warning" %}
If you clear the field, the app shows "Enter a tag name" and the page cannot be saved. Click **Discard** in the save bar, then enter the new name again.
{% endhint %}
{% endstep %}

{% step %}

### Save

Click **Save** in the bar at the top of the page. One save applies the changes to all three rules.
{% endstep %}
{% endstepper %}

## Tag rules

| Rule                         | Card              | Default tag                        | Added to | When the tag is added                                                                                            | When the tag is removed                                                                                                           |
| ---------------------------- | ----------------- | ---------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Recurring Order**          | **Order Tags**    | `ta_subscriptions_recurring_order` | Order    | When a renewal order is paid successfully. This includes renewal orders you create manually from a subscription. | Never. The tag stays on the order.                                                                                                |
| **Active Customer**          | **Customer Tags** | `ta_subscriptions_active_customer` | Customer | When a subscription is created or changes status, and the customer has at least one active subscription.         | When the customer no longer has any active subscription, for example after their subscriptions are cancelled, paused, or expired. |
| **Payment Failure Customer** | **Customer Tags** | `ta_subscriptions_payment_failure` | Customer | When a subscription moves to failed status after a payment fails.                                                | When the subscription becomes active again and the customer has no other subscription with a failed payment.                      |

{% hint style="info" %}
**Recurring Order** does not tag the first order a customer places at checkout. Only renewal orders get the tag.
{% endhint %}

## Existing subscriptions and orders

Tags are added and removed only when something happens to a subscription: it is created, changes status, or a renewal is paid.

* **Turning a rule on** does not tag existing customers or past orders. A customer gets the tag at the next change to one of their subscriptions.
* **Turning a rule off** does not remove tags that were already added.
* **Changes that happen while a rule is off** are not processed later. Turn the rules on before you rely on the tags.
* **Renaming a tag** does not change past orders. They keep the old tag. A customer's tag switches to the new name the next time one of their subscriptions changes.

## Pricing plans

On some plans, editing tag names is a paid feature. If the tag field is greyed out, you can still turn the rules on and use the default tags. To unlock tag editing, contact us via live chat.

## Good to know

* The app removes only the tags it added. Because tags are matched by name, removing a tag also removes the same tag if you added it to that customer by hand. Use a tag name that you do not apply manually.
* If you remove an app tag from an order or customer yourself, the app does not add it back.
* You cannot delete a rule. To stop using it, turn its switch off.
* Auto Tag does not send any email to your customers.
* To swap products in subscriptions automatically, see [Auto Product Swap](https://subscriptions-docs.tech-arms.io/features/email-notifications/auto-product-swap.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/features/email-notifications/auto-tag.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.
