Architecture Guide
Multi-Tenancy Architecture for B2B SaaS
B2B SaaS serves multiple customers (tenants) from one codebase. Shared DB, schema per tenant, or DB per tenant — each has tradeoffs. Here's how to choose.

Table of Contents
Shared Database
One DB, tenant_id on every table. Simplest. Row-level security. Best for most B2B SaaS. See our SaaS Architecture guide.
Schema Per Tenant
One DB, separate schema per tenant. Better isolation. Harder to manage at scale. For mid-market.
Database Per Tenant
Full isolation. For enterprise, compliance. Higher cost. Use when shared won't work.
When to Choose
- Shared: Default for most. Simple, scalable.
- Schema: Need more isolation, fewer tenants.
- DB per tenant: Enterprise, compliance requirements.

Frequently Asked Questions
Can we migrate from shared to DB per tenant?
Yes, for specific tenants (enterprise). Run both models. Migrate high-value tenants. Complex but doable.