Skip to main content

Tag subscription orders and customers

Appstle Subscriptions adds tags to your Shopify orders and customers for you. Use them to filter orders, build customer segments, send targeted emails, or trigger automations in apps that read Shopify tags. You choose the tag names, and you can add variables so a tag changes with each subscription.

What gets tagged

Appstle Subscriptions tags each subscription order and each customer who has a subscription. The table shows each tag, when Appstle adds it, and where you change it.

Tag

When Appstle adds it

Where you change it

First Time Order Tag

To the first order, when the subscription is created

More → Tag Settings

Recurring Order Tag

To each renewal order, after its payment succeeds

More → Tag Settings

Active customer tag

To customers with at least one active subscription

Journeys → Customer status tags

Paused customer tag

To customers with no active subscription and at least one paused one

Journeys → Customer status tags

Cancelled/inactive customer tag

To customers with no active or paused subscriptions

Journeys → Customer status tags

Appstle starts you with these default tags:

  • First Time Order Tag: appstle_subscription_first_order

  • Recurring Order Tag: appstle_subscription_recurring_order

  • Active customer tag: appstle_subscription_active_customer

  • Paused customer tag: appstle_subscription_paused_customer

  • Cancelled/inactive customer tag: appstle_subscription_inactive_customer

Unless a status tag uses a variable, exactly one of the three customer status tags stays on a customer at a time. The first order of a gift subscription also gets the tag Appstle gift. You can't change that tag.

Set the order tags

  1. In Appstle Subscriptions, select More, then Tag Settings.

  2. Under Order Tagging Settings, find First Time Order Tag or Recurring Order Tag.

  3. Type a tag, then press Enter or select Add Tag. Repeat to add more tags to the same field.

  4. To add a value that changes with each subscription, select Add Variables, choose a variable, and select Insert. Then select Add Tag.

  5. To remove a tag, select the × next to it. Each field needs at least one tag.

  6. Select Save in the bar at the top of the page.

The Preview above each field shows how your tags will look. It uses sample values for variables.

Use variables in tags

A variable appears in the field as text such as {{ customer.id }}. Appstle replaces it with the real value when it adds the tag. To combine your own text with a variable, type the text first, then insert the variable. For example, plan_ followed by Selling Plan Names becomes plan_monthly. These variables are available:

Variable

What it adds

Example

Customer ID

The Shopify ID of the customer

5143218323632

Subscription Contract ID

The ID of the subscription

1114833072

First Order ID

The ID of the first order of the subscription

3745777647792

Selling Plan IDs

The Shopify ID of the plan option the customer chose

605715765

Selling Plan Names

The Option name the customer chose in your subscription plan

monthly

Selling Plan Group Names

The Plan name of the customer's subscription plan

coffee subscription

Recurring Cycle

The order's number in the subscription: 1 for the first order, 2 for the first renewal

1

Cancellation Reason

The reason recorded when the subscription was cancelled

Too expensive

Billing Date (store timezone, YYYY-MM-DD)

The date the renewal order was billed, in your store's time zone. Available in Recurring Order Tag only.

2025-01-15

Use Cancellation Reason in the Cancelled/inactive customer tag. In order tags it's usually empty, because orders are tagged before a subscription is cancelled.

These limits apply to tags:

  • An order tag can be up to 40 characters once Appstle fills in the variables, which is Shopify's limit. If a real value, such as a long plan name, makes it longer, Appstle cuts the tag to its first 40 characters.

  • All the tags in one order tag field can be up to 255 characters together, and a variable counts by its full name: {{ customer.id }} counts as 17. Tag Settings shows All tags combined under each field and won't save a field that is over a limit.

  • Each customer status tag field can be up to 255 characters.

  • Appstle adds customer status tags in lowercase.

Set the customer status tags

Customer status tags are managed in Journeys. The Customer Tagging Settings section of Tag Settings shows the same values, but you can't change them there. Its Open journey button takes you straight to the journey.

  1. In Appstle Subscriptions, select Journeys. If you don't see it in the app menu, select View more.

  2. Find the Customer status tags card and select Edit tags.

  3. On the Customer status tagging step, select Edit.

  4. Change Active customer tag, Paused customer tag or Cancelled/inactive customer tag. To add a variable, select Add variable.

  5. Select Done, then Update journey.

By default, Appstle changes a customer's status tag as soon as their subscription status changes. If you select Update customer tags at the end of current billing cycle, the paused and cancelled tags are added just before the subscription's next order date instead, so the customer keeps the active tag until then.

If you leave Paused customer tag empty, paused customers get the cancelled/inactive tag instead.

Find the tags in Shopify

In your Shopify admin, open Orders and select an order to see its tags in the Tags card. To list every order with a tag, filter the Orders page by Tagged with. For a customer, open Customers, select the customer and look at Tags. To list every customer with a tag, create a customer segment with the filter customer_tags CONTAINS 'your_tag'.

Things to know

  • A change to a tag applies from then on. Orders that already have a tag keep it. When you change a status tag in Journeys, existing customers get the new tag the next time their status changes.

  • To update a customer's status tag now, open one of their subscriptions and select Sync Tags in the Customer Info card. To update many customers, select their subscriptions on the Subscriptions page, choose Bulk actions → Sync customer tags, then select Start Automation. If Bulk actions shows a lock, select it and choose Chat with us to unlock.

  • If a customer status tag has a variable, each subscription adds its own tag. A customer with several subscriptions can then have several status tags.

  • If the customer tag fields on your Tag Settings page are editable, change the status tags there instead. When you save, Appstle also swaps the old tag for the new one on your existing customers.

  • Tags work with any app or Shopify feature that reads tags, such as Shopify customer segments and email tools like Klaviyo. To email subscribers by status in Klaviyo, see Using Klaviyo to Email Subscribers by Customer Tag.

FAQs

Why is a renewal order missing the recurring tag?

Appstle adds the recurring tag only after a renewal payment succeeds, and only to orders created after you saved the tag. To check an order, open the subscription, select the Activity Logs tab and look for Order Tags Added on the order's date. A Failure badge there means Shopify didn't accept the tags.

Why can't I edit the customer tags on Tag Settings?

Those tags are managed in Journeys. Follow the steps in Set the customer status tags above.

What if Journeys shows Set up tags instead of Edit tags?

Your store's customer status tags journey hasn't been set up yet, so you can't edit the tags there. Contact support from the chat in the app, and they'll set it up for you.

Can I use tags to give subscribers different perks by plan?

Yes. Appstle doesn't give perks itself, but apps and Shopify features that read tags can. In the Active customer tag field, keep your current tag, type a comma, then type vip_ and add Selling Plan Group Names. A customer who subscribes to your Coffee Club plan then also gets the tag vip_coffee club. Use that tag in a Shopify customer segment or in an app that reads tags, such as a loyalty or content-locking app.

Why does a customer who cancelled still have the active tag?

Either they still have another active subscription, or Update customer tags at the end of current billing cycle is selected, so the change waits until just before their next order date. To apply the right tag now, open the subscription and select Sync Tags in the Customer Info card.

Did this answer your question?