How does multi-tenancy work?
Last updated: October 16, 2025
Multi-tenancy allows you to serve multiple independent organizations or user groups from a single SuperTokens instance, each with their own authentication configurations and user data. This is essential for B2B applications, SaaS platforms, and any system that needs to isolate authentication between different clients while sharing infrastructure.
Key Concepts
1. Tenants: A tenant is a group of users who share a common access with specific privileges to the application. Think of tenants as separate companies or organizations using your application. Each tenant can have its own user pool, authentication methods or even data isolation through separate databases.
2. Apps: Are the top level abstraction in the context of multi-tenancy in SuperTokens. Each app can have its own set of tenants and users, which can't be shared with other apps. For each app you need to have a separate backend and frontend SDK setup.
For detailed information on setting up multi-tenancy, managing tenants and apps, and implementation examples, see the Multi-Tenancy Documentation.