Skip to main content
A Tenant is the billing entity in Crovver. It is the unit that subscribes to a plan and accumulates usage. Depending on your org type, a tenant maps to different things in your app.

​
Tenant vs User

Crovver is not user-aware — it doesn’t know about individual users inside a workspace. It only knows about the billing unit.

​
External Tenant ID

Every tenant has an external_tenant_id — the ID of the corresponding entity in your application. You set this when creating a tenant or initiating checkout.
Crovver uses this to look up tenants when your app makes API calls.

​
Tenant Owners

A Tenant Owner is the person responsible for billing — the person whose card gets charged. For B2B tenants, this is typically the account admin who signed up.

​
Creating Tenants

For B2B apps, you explicitly create tenants (workspaces) and link users to them. For D2C apps, tenants are auto-created on first checkout — Crovver creates a tenant for each user automatically.

​
Tenant Status

A tenant is considered active if it has at least one subscription with status active or trial. Your frontend can check this via useSubscription().isActive.