Organizations

An organization is the account boundary above a tenant: "Group existing tenants under an organization and centralize billing." It is where the subscription lives, and where you consolidate several tenants that belong to the same company.

The hierarchy is Organization > Tenant > Project > Environment. An organization holds tenants; it does not hold projects directly.

Organization list

The header reads "Organizations", with a card/table view toggle, an All subscriptions filter, and a "New Organization" button.

Each organization card shows:

• The label Organization and a subscription-tier badge (for example ENTERPRISE)
• The organization name and description
• A tenant count badge
• The last-updated time
• A copy button for the organization ID

Use the All subscriptions dropdown to filter by tier when you administer many organizations.

Create an organization

1. Click "New Organization" — or use the "+" button in the top bar.
2. Enter a name and optional description.
3. Existing tenants can then be linked to the organization.

Once linked, the organization name appears in the console breadcrumb ahead of the tenant, and in the organization filter rail on the Tenants and Projects pages.

Why the level exists

Two reasons:

Billing. The subscription tier is set per organization, so several tenants can share one contract rather than each carrying its own plan. The tier shown on a tenant card is inherited from its organization.

Administration. Grouping tenants under an organization gives you a filter that follows you around the console — the org rail on Tenants and Projects, and the leading breadcrumb segment on every module page.

Organizations in the console vs in your app

Do not confuse this with B2B organizations inside your own application. This page groups your tenants for billing and administration. Modelling customer organizations, memberships, and invitations for the users of your app is a separate feature — see Organizations and Multi-tenancy.

Related