concepts
Settings Cascade
How settings inherit from org to domain assignment.
Inheritance Model
The effective value is resolved most-specific-first: a domain assignment overrides the domain, which overrides the org, which falls back to the system default.
System Defaults → Org Settings → Domain Settings → Domain Assignment Settings → Effective SettingsDuring inbox creation, default_inbox_ttl resolves through an additional team tier (Team → Domain → Org → System Default).
Configurable Settings
| Setting | Level | Description |
|---|---|---|
attachments_enabled | Org, Domain, Assignment | Whether file attachments are accepted |
max_attachment_size_mb | Org | Maximum attachment file size |
default_inbox_ttl | Org, Domain, Team | Default inbox lifetime |
max_inbox_ttl | Org, Domain, Assignment | Maximum inbox lifetime |
max_domains | Org | Maximum domains per org |
max_teams | Org | Maximum teams per org |
max_inboxes_per_domain | Org, Team | Maximum active inboxes per domain (the team value is an additional cap on top of the org value) |
renewal_policy | Org | How an extend with no explicit duration is sized: original (default — reuse the inbox's creation TTL), default (re-resolve the cascade), fixed (use renewal_ttl) |
renewal_ttl | Org | Fixed renewal duration; read only when renewal_policy is fixed |
enforce_sso | Org | Require SSO for all members |
Example
If the org has attachments_enabled: true and max_attachment_size_mb: 25, but a specific domain assignment overrides with attachments_enabled: false, then inboxes on that assignment will not accept attachments.
Org-level settings are managed on the Settings page. Domain assignment settings are managed on the Teams page when editing domain assignments.
Which Tiers Each Setting Uses
Not every setting walks every tier:
default_inbox_ttl— Team → Domain → Org → system default (no assignment tier)max_inbox_ttlandattachments_enabled— Assignment → Domain → Org → system default (no team tier)max_inboxes_per_domain— Org → system default, with the team's value applied afterwards as an additional capmax_attachment_size_mb— Org only
Declared but Unused
Three fields are accepted and stored but never read, so setting them has no effect today:
TeamSettings.attachments_enabledandTeamSettings.max_inbox_ttl— both resolve through the assignment → domain → org chain onlyDomainSettings.max_inboxes_per_domain— inbox creation reads the org value and the team cap, skipping the domain tier