Multi-Tenancy Pattern

Managing multiple workspaces, organizations, and contexts within a single application with clear data isolation and seamless switching.

Interactive Tenant Switcher

The tenant switcher allows users to seamlessly switch between different workspaces or contexts.

💼

Work Workspace

3 members

Tenant Cards

Show available tenants as cards for selection or management.

👤

Personal

💼

Work Workspace

3 members

Active
👨‍👩‍👧‍👦

Family

4 members

Data Isolation Indicator

Clearly show users which tenant context they're viewing data from.

Usage Guidelines

When to use

  • Users need to separate personal and work data
  • Users manage multiple organizations or teams
  • Data must be isolated between contexts
  • Different permissions apply per tenant

Best practices

  • Always show current tenant prominently
  • Use visual indicators (colors, icons) to differentiate tenants
  • Make tenant switching easily accessible
  • Clearly indicate data isolation boundaries
  • Persist tenant selection across sessions

Accessibility

  • Announce tenant switches to screen readers
  • Provide keyboard shortcuts for tenant switching
  • Ensure tenant indicators meet contrast requirements
  • Use clear labels, not just colors or icons

Do's and Don'ts

Do

  • Clearly show which tenant is currently active
  • Use visual indicators to differentiate tenants
  • Make switching between tenants easy and quick
  • Confirm tenant switches for destructive actions

Don't

  • Hide the current tenant context
  • Mix data from multiple tenants without clear labels
  • Make tenant switching hard to find
  • Rely only on color to indicate tenants

Related Components

Resources