> For the complete documentation index, see [llms.txt](https://docs.roadmap.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roadmap.so/subscriptions/managing-subscriptions/the-customer-subscription-history-card.md).

# 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.

| Surface                                        | What it counts                                                                                 |
| ---------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| 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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.roadmap.so/subscriptions/managing-subscriptions/the-customer-subscription-history-card.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.