Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.supercycle.com/llms.txt

Use this file to discover all available pages before exploring further.

Shopify Segments let you group customers based on attributes like purchase history, location, or tags. Because Supercycle automatically applies tags to your customers and orders, you can use Segments to slice your circular commerce audience without any extra setup.

​
Tags Supercycle applies

Supercycle writes the following tags. The full reference lives in Customer tags.

​
Customer tags

TagApplied when
Supercycle memberCustomer has placed any rental order
Has active subscriptionCustomer has an active membership or subscription
Has paused subscriptionCustomer has paused their membership or subscription
Has canceled subscriptionCustomer has canceled their membership or subscription
{Plan name} subscriberCustomer is on a specific membership plan (e.g. Starter Subscriber)

​
Order tags

TagApplied when
Has rental productsOrder contains rental products
Has membershipOrder contains a membership plan product
Recurring order #XThe Nth recurring order in a subscription or membership (e.g. Recurring order #1)
Tags are applied and updated automatically as customers move through the rental lifecycle. You don’t need to manage them manually.

​
Create a segment

1

Open Segments in Shopify

In your Shopify admin, go to Customers > Segments.
2

Create a new segment

Click Create segment and use the query builder to define your criteria.
3

Filter by Supercycle tags

Use the Customer tags filter to include or exclude customers. For example, to target everyone with an active subscription:
customer_tags CONTAINS 'Has active subscription'
Combine tags with other Shopify filters (location, lifetime spend, last order date) for sharper segments.
4

Save the segment

Click Save segment and give it a name. The segment becomes available across Shopify — for marketing campaigns, discounts, and reports.

​
Example segments

​
Active subscribers

Target customers currently subscribed for retention or upsell campaigns: 
customer_tags CONTAINS 'Has active subscription'

​
Paused subscribers ready to win back

Re-engage customers who paused but haven’t canceled: 
customer_tags CONTAINS 'Has paused subscription'
AND customer_tags NOT CONTAINS 'Has canceled subscription'

​
High-value renters

Combine rental activity with spend to find your best circular customers: 
customer_tags CONTAINS 'Supercycle member'
AND amount_spent >= 500

​
Plan-specific upsell

Target a specific plan to promote upgrades: 
customer_tags CONTAINS 'Starter Subscriber'

​
Renters who haven’t subscribed

Find one-off rental customers to convert into subscribers: 
customer_tags CONTAINS 'Supercycle member'
AND customer_tags NOT CONTAINS 'Has active subscription'

​
Where to use segments

Segments work everywhere Shopify supports them:
  • Email marketing — Shopify Email, Klaviyo, and other tools that sync segments
  • Discounts — restrict a discount code to a specific segment
  • Reports — filter Shopify Analytics reports by segment to compare cohort performance
  • Customer accounts — show different content based on segment membership
Segments are dynamic — Shopify recalculates membership as tags change, so a customer who pauses their subscription automatically moves between segments without manual cleanup.