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_orderRecurring Order Tag:
appstle_subscription_recurring_orderActive customer tag:
appstle_subscription_active_customerPaused customer tag:
appstle_subscription_paused_customerCancelled/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
In Appstle Subscriptions, select More, then Tag Settings.
Under Order Tagging Settings, find First Time Order Tag or Recurring Order Tag.
Type a tag, then press Enter or select Add Tag. Repeat to add more tags to the same field.
To add a value that changes with each subscription, select Add Variables, choose a variable, and select Insert. Then select Add Tag.
To remove a tag, select the × next to it. Each field needs at least one tag.
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.
In Appstle Subscriptions, select Journeys. If you don't see it in the app menu, select View more.
Find the Customer status tags card and select Edit tags.
On the Customer status tagging step, select Edit.
Change Active customer tag, Paused customer tag or Cancelled/inactive customer tag. To add a variable, select Add variable.
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.



