Tag Settings

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
• Customer tags
• Order tags
• Changing the tag text
• Variables in tags
• Using tags to email or segment subscribers
• Common questions
• 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

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:

To put the subscription's ID, the subscription option's name or the order number in a tag, use a variable.

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 variable ({{ contract_order_number }} or {{ contract_renewal_number }}), which the app replaces with the order's number. Tags saved with the older single brace form, such as { contract_order_number }, keep working.

Variables in tags

Order tags and the Has subscription contract customer tag can include variables, which the app fills in for each order or subscription. Click a variable under the tag in Edit tag to add it, and the example under it shows what the tag will look like.

For example, an order tag plan {{ subscription_name }} reads plan Delivered every month, and a Has subscription contract tag subscriber {{ subscription_id }} gives the customer one tag per subscription.

• The status tags (Has active subscription, Has paused subscription and the rest) describe the customer as a whole, so they stay plain text and take no variables.
• A tag with {{ product_title }} or {{ variant_title }} is written once for each product on the subscription, so a subscription to coffee beans and green tea gets two tags.
• Tags written before {{ delivery_frequency }} existed may use {{ frequency }}. It keeps working and is filled in with the delivery frequency.
• Shopify allows up to 40 characters in a tag. When a filled-in tag is longer, the app shortens the product or variant name (or the option name) first, so your own words and numbers stay. The text you type yourself, without the variables, must fit in 40 characters, or Edit tag refuses it.
• Shopify does not allow commas in a tag, so a comma in a filled-in value becomes a space.
• When you change a tag that uses variables, the app replaces the tags the old text wrote on your existing customers and orders.

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 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, which uses the Has subscription contract tag to build a new-subscriber-only segment.
• Subscription Analytics
• Using Supr Bundles & Subscriptions with other apps and tools

Updated on: 10/11/2026