Tenant entitlements (TenancyEngine)
Assign the active offering (L1 plan) for a customer tenant. The offering drives runtime feature flags, limits, and billing product codes for that tenant on your application.
Console: TenancyEngine console → Tenants → Edit → Entitlements tab
Requires Tenants write to assign or change a tenant plan.
What you see
The Tenant plan panel shows the current entitlement when one is assigned:
- Offering — display name and slug from your application's product catalog
- Status — active, suspended, or other lifecycle state from the entitlement record
- TenaBill product — when the offering is linked to a TenaBill product code for billing sync
When no offering is assigned, the panel prompts you to choose a production contract offering.
Assign or change a plan
- Open Tenants and click Edit on the tenant row.
- Select the Entitlements tab.
- Choose an active offering from the dropdown (production contract offerings for the tenant's application).
- Click Assign plan.
The assignment takes effect for runtime entitlement checks and usage meters. Changing plans may affect feature access immediately depending on your application's contract rules.
Offerings vs platform plans
| Scope | What it controls | Where to configure |
|---|---|---|
| Platform plan (L0) | Vendor org caps (platform.apps.max, custom domains, etc.) | Organizations, Billing |
| Application offering (L1) | Tenant feature entitlements on your product | Application offerings |
| Tenant entitlement | Which L1 offering a customer tenant receives | This screen |
Do not confuse L0 platform plans with L1 tenant offerings — they operate at different layers.
Prerequisites
- At least one active offering on the application's Production contract environment.
- Define features and limits on offerings before assignment; see Application offerings.
Related
- Tenants — directory, edit modal tabs, and usage
- Application offerings — create and promote sellable plans
- Application features — capabilities bundled into offerings