Subscriptions
The Subscriptions view is an operational overview of every Lumio account and its current plan — effectively a read-only "who is paying for what" list. It shares the same underlying admin accounts endpoint as the Accounts page but is optimised for billing operators who only care about the plan mapping, not the per-account members or limits.
Where to find it
Admin sidebar → Subscriptions (/subscriptions).
Quick start
- Open Admin → Subscriptions.
- Search by account or owner display name.
- Scan the plan column for
free/pro/enterprisebadges. - Page through with Previous / Next at the bottom.
- For actual plan changes, coupon application, or limit overrides, click through to the account — the Subscriptions page is read-only.
Detailed walkthrough
Table columns
- Account — account name, click-through to
/accounts/\{id\}(detail page). - Owner — display name of the owning user.
- Plan — coloured badge (
free,pro,enterprise). - Members — member count on the account.
- Created — account creation date.
Search
Debounced search on account name and owner name. Resets pagination to page 1 on each keystroke.
Pagination
25 accounts per page, footer reads "Page X of Y (N accounts)".
Common scenarios
- "How many Enterprise accounts exist?" — eyeball the plan column or filter by plan via search (free-text search does not filter by plan directly; use the Accounts page or the dashboard stats on Billing).
- Look up the owner of a given account's subscription — search by account name; Owner column has the name.
- Churn investigation — sort by Created descending, look for recent account creation tied to a downgrade event.
Permissions
| Action | Permission |
|---|---|
| View subscription overview | subscriptions:read |
| (Future) edit subscription fields | subscriptions:edit |
Dashboard entry requires admin:access. System admins hold both implicitly.
API
The Subscriptions page is a thin view over the admin accounts endpoint; there is no dedicated adminSubscriptions query.
| UI action | GraphQL | REST |
|---|---|---|
| List accounts + plan | adminAccounts | GET /v1/admin/accounts |
For the authoritative subscription data (status, renewal date, cancel-at-period-end), look inside the Stripe Dashboard against the account's stripe_customer_id. Lumio stores the current plan slug but not the full Stripe subscription object.
Tips & gotchas
- This page does not show subscription status (active / past-due / cancelled). It shows the
plancolumn on the accounts table, which is set locally by admin actions or Stripe webhooks. - For refunds, mid-cycle proration, or subscription cancellation, use the Stripe Dashboard.
- To change a plan without Stripe (e.g. comp an Enterprise customer), use Accounts → Plan Management. That path writes the local plan slug but does not touch Stripe.
- Users can belong to many accounts. The Owner column is the owner of this account, not necessarily the paying party if billing was delegated (edge case).