> For the complete documentation index, see [llms.txt](https://subscriptions-docs.tech-arms.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://subscriptions-docs.tech-arms.io/features/analytics/subscriptions.md).

# Subscriptions

Follow how many subscriptions start, pause, cancel and come back, and check renewal results, churn and cancellation rates.

The **Subscriptions** tab shows how your subscriber base changes. Use it to spot rising cancellations or failed charges early and to see whether customers come back.

In the app menu, click **Analytics**, then click the **Subscriptions** tab.

![The Subscriptions tab with its ten cards](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FgX2iSDLNfepVJZc5rSjs%2Fanalytics-subscriptions-cards.png?alt=media)

The tab uses the date range and **Compare to** period at the top of the page. To learn how to change them and how to read a card, see [Analytics](https://subscriptions-docs.tech-arms.io/features/analytics.md).

## How statuses are counted

A subscription can be **Active**, **Paused**, **Cancelled**, **Failed** or **Expired**. The cards use each subscription's status **today**, together with the date of its **latest** status change:

* A subscription paused in the period counts as paused only if it is still paused today.
* A subscription paused in the period and reactivated later counts as reactivated, on the date it was reactivated.
* Creating a subscription is not a status change. New subscriptions are counted by their creation date.

## Subscription cards

| Card                                | What it counts                                                                                                                                                                                                                                                                 |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Total active subscriptions**      | Subscriptions created in the period that are still active today.                                                                                                                                                                                                               |
| **Total reactivated subscriptions** | Subscriptions that became active again in the period, after being paused, cancelled or failed, and are still active today. It includes reactivations by you, by the customer in the customer portal, and by automations. A subscription reactivated several times counts once. |
| **Total paused subscriptions**      | Subscriptions paused in the period that are still paused today.                                                                                                                                                                                                                |
| **Total cancelled subscriptions**   | Subscriptions cancelled in the period that are still cancelled today.                                                                                                                                                                                                          |
| **Total same day cancellations**    | Subscriptions created in the period and cancelled on the same day they were created, that are still cancelled today. A high number can point to checkout mistakes or customers who did not mean to subscribe.                                                                  |

## Renewal cards

| Card                              | What it counts                                                                                                                   |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **Total recurring orders**        | Renewal orders placed in the period, that is, renewal charges that succeeded. First orders are not included.                     |
| **Total failed recurring orders** | Renewal charges that failed in the period. Every failed attempt counts, so a renewal that failed twice before succeeding adds 2. |
| **Billing success rate**          | Successful renewal charges ÷ all renewal charges in the period (successful and failed) × 100. This card has no comparison.       |

## Rate cards

| Card                  | How it is calculated                                                                                                                                                                                                                          |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Churn rate**        | Subscriptions cancelled in the period and still cancelled ÷ all subscriptions created before the period started × 100.                                                                                                                        |
| **Cancellation rate** | Of the subscriptions created in the period, the share that is not active today: (subscriptions created − those still active) ÷ subscriptions created × 100. Paused, failed and expired subscriptions count here too, not only cancelled ones. |

For both rates, the change indicator shows the difference between the two periods in percentage points. A rise shows in red.

### Example: Churn rate

Before June 1 your store had 200 subscriptions created in total. In June, 10 subscriptions were cancelled and are still cancelled. With **Last month** selected in July, **Churn rate** shows 10 ÷ 200 × 100 = 5%.

{% hint style="info" %}
**Churn rate** divides by every subscription created before the period, including ones that were already cancelled or expired. If many old subscriptions have ended, the churn rate looks lower than the share of your current subscribers who left.
{% endhint %}

## Charts

![The Subscriptions per Day, Subscribed vs. Unsubscribed and Total active subscriptions over time charts](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FToJqBUiXpuBwU20C7NUC%2Fanalytics-subscriptions-charts.png?alt=media)

### Subscriptions per Day

The number of new subscriptions created in each day of the period. Use the menu in the top-right corner to group by **Daily**, **Weekly**, **Monthly** or **Yearly**. When a comparison is on, a second line shows the comparison period.

### Subscribed vs. Unsubscribed

Two lines over the period:

* **Subscribed**: subscriptions created on each date that are still active today.
* **Unsubscribed**: subscriptions cancelled on each date that are still cancelled today.

### Total active subscriptions over time

How the number of active subscriptions changed across the period, day by day. The line starts at zero on the first day of the period. Each day it adds subscriptions that were created or reactivated and subtracts those that were paused, cancelled, failed or expired.

{% hint style="warning" %}
This chart shows the change since the start of the period, not your total number of active subscriptions. To see how many subscriptions are active right now, go to [Subscriptions](https://subscriptions-docs.tech-arms.io/features/subscriptions.md) and filter by status.
{% endhint %}

## Good to know

* To reduce failed renewals, review your retry settings in [Renewal & Dunning](https://subscriptions-docs.tech-arms.io/features/email-notifications/renewal-and-dunning-settings.md) and the reasons in [Billing error codes](https://subscriptions-docs.tech-arms.io/resources/help-center/troubleshooting-guide.md).
* Statuses come from Shopify. A subscription cancelled or paused in Shopify admin or by another app is counted the same way as one changed in this app.

*If you need help, feel free to reach out to us via in-app* [***Live chat***](https://go.crisp.chat/chat/embed/?website_id=c4ae10a3-f762-4968-b35a-c931caf62a96)***,*** [***Book a call***](https://calendly.com/ta-subscription-app-support/30min) *or at* [***support@tech-arms.io***](mailto:support@tech-arms.io)***.***


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://subscriptions-docs.tech-arms.io/features/analytics/subscriptions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
