Subscriptions
Subscriptions in the Business area (Subscriptions) — route /business/subscriptions.
Subscriptions lives in the Business area of the dashboard, under Subscriptions.
At a glance#
| Dashboard route | /business/subscriptions |
| Area | Business (business) |
| Group | Subscriptions |
| Platforms | Available for every app platform. |
What it does#
The subscription roster: every subscription with its status, value and dates, filterable by status, with a drawer per subscription.
Like the other subscription pages it operates in one of two modes, shown by a badge:
Real — event-sourced projections built from subscription lifecycle events. The roster is what your events say it is.
Approximated — derived from subscription-tagged purchases, because no lifecycle events exist.
When to use it#
For per-customer questions — who is on what plan, whose subscription is in which state, what happened to a particular account. MRR is the aggregate; this is the list behind it.
Also as the reconciliation point against your billing system. Where the two disagree, the difference is almost always an event your app did not send.
Workflow#
Check the mode
An approximated roster is inferred. It will contain subscriptions that have actually ended.
Filter by status to find problems
Statuses other than active are where the interesting cases sit — past due, cancelled, trialing.
Open the drawer for one subscription's history
The sequence of events is what explains a state that looks wrong.
Reconcile against billing periodically
This is your product's view of subscriptions, not your payment provider's. They should agree; when they do not, this one is missing an event.
Permissions and prerequisites#
Real mode requires subscription lifecycle events from your app or your billing integration.
Limits and edge cases#
Approximated mode cannot see cancellations until a renewal fails to arrive, so it overstates active subscriptions.
A missed event leaves a subscription in a stale state indefinitely — projections apply what they receive.
Trials appear here and have their own page, Trials, which is real-mode only.
Troubleshooting#
A cancelled subscription still shows active. In approximated mode, expected. In real mode, the cancellation event was not sent.
Roster does not match billing. Compare event by event in the drawer. A gap in the sequence is your answer.
Where the data comes from#
Served by
Subscriptions