Last verified: 2026-05-30
Subscription and plan limits
Understand your SaaS plan, billing, and resource limits that gate organizations, locations, staff, and catalog size. Your storefront (direct ordering web app) features depend on the active plan.
Dashboard path
/admin/subscription — Subscription Management — Manage your subscription, billing, and payment methods.
What you can do here
- View current plan and billing cycle
- Manage payment methods (per integrated billing provider)
- See feature availability tied to the subscription
- Upgrade/downgrade when self-serve plan changes are enabled
Resource limits (enforced in product)
The platform enforces limits via enforceLimit / checkLimit on actions such as:
| Resource | Example action blocked |
|---|---|
| Organization | Creating another org when at plan max |
| Sub-organization | Adding another location/branch |
| Staff | Inviting beyond seat cap |
| Product | Creating items over catalog limit |
Error messages are user-facing (e.g. “You have reached the maximum number of organizations allowed by your current plan.”).
Where limits surface
| Task | Symptom when over limit |
|---|---|
| Add organization | Toast/error on create |
| Add location | Create button disabled or error from server |
| Send staff invite | Invitation rejected |
| Add product | Empty state or cannot create |
Steps — check your plan
- Open
/admin/subscription. - Note plan name, renewal date, and included features.
- Before large setup (many branches or SKUs), confirm headroom for locations and products.
- Upgrade from the same page if billing UI offers plan change.
Performance rebate / commission billing
Some plans include performance rebate or commission-based billing configured at platform level. Merchant-facing details appear in subscription UI; platform logic is documented for engineering in docs/COMMISSION_BILLING_PERFORMANCE_REBATE_LOGIC.md (not duplicated here).
