Overview
Tenants are hierarchical groups that map to organizations, teams, projects, or environments. They scope notifications with tenant-specific preferences, branding, and metadata.Why tenants matter
One workspace can serve many customers or orgs without duplicating templates. Each tenant gets its own defaults (preferences, branding, provider credentials), so the same flows adapt per context. Useful for B2B SaaS, white-label products, and scoped inboxes or preferences per customer or project.Key Features
Courier’s tenant system provides comprehensive multi-tenant notification management with features including:- Hierarchical Organization - Create parent-child tenant relationships with up to four layers of inheritance
- Scoped Preferences - Set tenant-specific default preferences that users can override on a per-tenant basis
- Custom Branding - Apply different brands and visual styling based on tenant context
- Provider Credentials - Store tenant-specific provider keys (Slack workspace tokens, custom SMTP credentials)
- Flexible Targeting - Send to individual users with tenant context, all tenant members, or nested hierarchies
- Metadata Management - Attach custom properties and profile data that templates can reference
- Send Limits - Configure maximum send limits per tenant for usage control
Core Components
Hierarchical Organization
Create parent-child tenant relationships with up to four layers of inheritance. Child tenants inherit and can override parent metadata, preferences, and branding. Example mapping:Companies → Teams → Projects → Environments