How do organizations (multi-tenancy) work?

Q: How do organizations (multi-tenancy) work?

Organizations are how Atlas models B2B multi-tenancy: Membership — users join one or more organizations. The active organization is part of the session, and appears in the JWT so your backend knows the tenant context. Isolation — org-scoped data is scoped at the repository layer, so no request can read across organizations. Per-org configuration — each organization can have its own roles, invitations, SSO connection (SAML/OIDC), SCIM provisioning, domains and policies. Org switching — the SDKs expose the user's organizations and let them switch the active one. This makes Atlas suitable for B2B SaaS from day one, not as a bolt-on. See the organizations guide.

Topic: Organizations & RBAC
Asked by: Developers building B2B apps

AdminUpdated Sep 11, 2026

Organizations are how Atlas models B2B multi-tenancy:

Membership — users join one or more organizations. The active organization is part of the session, and appears in the JWT so your backend knows the tenant context.
Isolation — org-scoped data is scoped at the repository layer, so no request can read across organizations.
Per-org configuration — each organization can have its own roles, invitations, SSO connection (SAML/OIDC), SCIM provisioning, domains and policies.
Org switching — the SDKs expose the user's organizations and let them switch the active one.

This makes Atlas suitable for B2B SaaS from day one, not as a bolt-on. See the organizations guide.

Organizations are Atlas's multi-tenant primitive. A user can belong to one or more organizations; all org-scoped data is isolated at the data layer, and each org can have its own roles, members, SSO and settings.

Was this page helpful?

How do organizations (multi-tenancy) work?

If that was not it