The Customer Subscription History card
Lifetime subscription totals for a customer — what the card shows, where the numbers come from, and how it differs from the Activity Timeline.
Every contract detail page shows a Customer Subscription History card in the right rail with the customer's all-time subscription totals. This article explains what those numbers count and how they're different from the contract-specific data on the same page.
Where to find it
Open any contract from Subscriptions → Manage Subscriptions. The Customer Subscription History card is in the right-side rail, beneath the Customer card and above (or near) the Loyalty Points card.
What the card shows
Two lifetime totals for this customer across all of their subscription contracts, not just the one you're viewing:
Orders — total successful subscription orders the customer has had across every contract, ever
Products — total subscription product units the customer has bought across all those orders
A customer with two contracts — one currently active with 6 orders billed, one previously cancelled after 4 orders — would show 10 orders total. If those orders averaged 2 line-item products each, 20 products total.
What the card doesn't count
Failed billing attempts — only successful orders are tallied.
One-time purchases — only orders that came from subscription contracts count. A customer's regular non-subscription order history isn't reflected here.
Future scheduled orders — only orders that have actually billed and shipped.
Orders on contracts in Cancelled status — these stay in the totals (a cancelled contract that delivered 4 orders still counts those 4).
How this differs from other counts on the same page
The contract page has multiple places where "how many orders" appears, and they count different things.
Customer Subscription History card (this card)
Lifetime orders & products across every contract the customer has had
Orders list on the contract
Past + Upcoming orders for this contract only
Activity Timeline
Every event (orders, status changes, payment events, customer actions) for this contract only
Subscription auto-tagging count
Lifetime orders or products across all contracts (same as this card) — used to match tag rules
If a customer asks "how many orders have I had?" the Customer Subscription History card is the right answer. If they ask "how many on this specific subscription?" the contract's Orders list is the right answer.
Why this card matters
Customer support — quick context when the customer's call is about loyalty, lifetime value, or a long history.
Tag rule debugging — Subscription auto-tagging uses the same lifetime totals to match tag rules. If a customer says they should have a "10-orders" tag and don't, this card tells you whether they actually have 10 orders.
Manual VIP recognition — for stores that don't use auto-tagging, this card is the single source of truth for who your highest-value subscribers are.
Common scenarios
"The card says 12 orders but the customer has only one contract with 8 orders"
The customer has another contract you're not currently viewing. Open Subscriptions → Manage Subscriptions, search for the customer's email, and check whether they have additional active or cancelled contracts.
"The card says fewer products than the customer claims"
Two possibilities: either some of the orders failed and didn't ship (only successful orders count), or some of what they're counting were one-off non-subscription purchases (not counted here).
For the full event-by-event picture of what happened on the current contract, switch to the Subscription Activity Timeline panel on the same page.
Related guides
The Manage Subscriptions admin: a tour
The Subscription Activity Timeline
Subscription auto-tagging
Last updated