A subscription belongs to a tenant — and the tenant gets the package's features. This article covers how that link is established and managed.
How the Link Forms
- Self-service signup: A new tenant is created during checkout; the subscription is attached at the moment of payment.
- Admin assignment: Admin manually grants a tenant a subscription (useful for migrations, beta partners, gifts).
- API: A provisioning system creates tenant + subscription together.
Viewing and Changing
Open Architect Panel → Tenants, click the tenant, then the Subscription tab. You can:
- See current plan, renewal date and next invoice amount.
- Change plan immediately or at next renewal (proration handled by Stripe).
- Apply a discount code retrospectively.
- Pause or cancel.
- View full history of plan changes for audit.
Worked Examples
- Upgrade to Pro: Customer clicks Upgrade in the app. Plan changes immediately, prorated charge appears on next invoice.
- Downgrade to Free: Customer downgrades; the platform delays the actual change until the end of the current billing period so they get what they paid for.
- Admin grants Business: A partner gets a complimentary Business plan. Admin clicks Change plan, no charge applied.
- Acquisition migration: 200 acquired customers migrated; each tenant created with subscription set to “Legacy Pro” at a grandfathered price.
Note: If a tenant has multiple subscription packages (e.g. a base plan plus add-ons), each is its own subscription with its own renewal date. The tenant gets the union of features from all active subscriptions.