View your plan & usage

The Billing page (sidebar Billing) is the single place to check your current plan, see how much of your monthly allotment you’ve used, manage your payment method, and download invoices.

Permission note: the Billing page requires the manage_billing permission. Team members on roles without that permission can’t see the page or its sidebar entry.

When to use it

Mid-month, when you want to see how you’re tracking against your event allotment.
After receiving a “limit exceeded” or “grace period” notification email.
When updating your payment method or downloading invoices for accounting.
When deciding whether to upgrade, downgrade, or cancel.

Page layout

The page is composed of several stacked sections, in order:

1. Migration banner (conditional)

If your current plan has been scheduled for retirement and a successor plan is configured, a banner appears at the top noting the migration deadline. You can preview the successor’s terms via the banner’s “View details” link. Most tenants don’t see this banner — it only shows when your plan is being phased out.

2. Current Plan section

The headline section. It shows:

Plan name — Trial / Starter / Pro / Business / Enterprise.
Cap state badge — one of:
- Active (green) — normal operation; your usage is within the included allotment.
- Limit Exceeded (yellow) — you’ve passed your monthly event allotment but a grace period is still in effect.
- Grace Period (orange) — you’re inside the grace window after exceeding the cap. After grace expires, ingestion stops on cap-policy plans (Trial, Starter).
- Ingestion Paused (red) — hard-capped. The API is rejecting events with 402 until you upgrade or wait for the next billing cycle.
Usage — events ingested this month, against your plan’s monthly allotment, with a progress bar.
Storage used — total storage consumed against your plan’s storage limit.
Manage Subscription button — redirects to the Stripe customer portal. Use this to update your payment method, view past invoices and receipts, change billing address, or download tax documents.
Cancel Subscription button — opens the cancel confirmation modal. See Cancel subscription.

The cap-state distinction matters: cap-policy plans (Trial, Starter) hard-cap ingestion when the allotment is exhausted. Pro and Business are charge-policy — overage is metered and billed per-event rather than blocking ingestion. Enterprise is custom (unlimited by default; no hard cap on overage). See Cap exceeded behavior for the full set of states and transitions.

3. Usage history (conditional)

Shown only when you have an active subscription. A historical view of past billing periods — events ingested per period, overage charges (if applicable), and total cost. Helpful when budgeting or projecting growth.

4. Invoice history (conditional)

Also shown only when you have an active subscription. A list of past invoices with download links. Each row shows the invoice date, period, amount, and a Stripe-hosted link to download the PDF. (For receipts, payment-method updates, and tax-related operations, prefer the Stripe customer portal via Manage Subscription.)

5. Plan Picker

A monthly / annual toggle followed by a row of plan cards. Annual saves roughly two months versus monthly. Click any card to change plans — see Upgrade or downgrade for the flow. Enterprise is “Contact Sales” rather than self-serve.

6. Feature comparison table

A side-by-side matrix showing every feature across all plans. Useful when you’re trying to decide which tier you actually need.

Common questions

My usage shows 0 but my application has been sending events. Cap-status data is rebuilt every 15 minutes. Check back shortly; for real-time confirmation of ingestion, the Invalid Events and Actor Identities pages in the dashboard update within seconds.

I’m in Grace Period — what happens next? On cap-policy plans, ingestion stops when the grace window ends. On charge-policy plans, your account remains active and overage starts billing at the next invoice. Either way, an email goes to the billing contact when the state changes.

→ Upgrade or downgrade