Account Modes

Configure personal, organization, or hybrid account modes for your SaaS.

The SaaS Kit supports three account modes to match your business model:

  • Personal Only (B2C) - users have individual accounts only
  • Organizations Only (B2B) - users belong to organizations and cannot assign entities to their personal account (most B2B use cases)
  • Hybrid (B2B2C) - users can have both personal and organization accounts - like Github

Personal Only (B2C)

For consumer SaaS and individual users.

  • Users have individual accounts only
  • No organization or team features
  • Personal billing only
  • Simpler UI without account switching

Organizations Only (B2B)

For enterprise SaaS and team collaboration.

  • Users must belong to organizations
  • No personal account context
  • Organization billing only
  • Auto-creates organization on sign-up

Hybrid (B2B2C) - Default

For flexible platforms serving both individuals and teams.

  • Users can switch between personal and organization contexts
  • Both billing types supported - but we recommend sticking to one or the other, not both.
  • Full account switcher
  • Maximum flexibility

Configuration

Set the mode via environment variable:

# Personal accounts only (B2C)
NEXT_PUBLIC_ACCOUNT_MODE=personal-only
# Organizations only (B2B)
NEXT_PUBLIC_ACCOUNT_MODE=organizations-only
# Hybrid mode (Default)
NEXT_PUBLIC_ACCOUNT_MODE=hybrid

Feature Flag Overrides

These are auto-derived from the mode but can be overridden:

NEXT_PUBLIC_ENABLE_PERSONAL_ACCOUNT_BILLING=true
NEXT_PUBLIC_ALLOW_USER_TO_CREATE_ORGANIZATION=true

Next: Environment Variables