branding
Tenant branding tokens (title, description, site URL, accent colour, logo, layout preset, optional custom CSS) read by managed pages, mail and PDF renderers and the document designer; set via config:write:set on branding:config:*, read via branding:query:tokens. Keys are write-validated (hex colour, https URLs, FileRef id) and readable anonymously so public pages can render them; a configEdit self-service screen (branding:screen:branding-settings) edits them. Raw custom CSS exists only when the app passes allowCustomCss and is additionally gated per tenant by the branding-css toggle. Requires config.
How it fits
Section titled “How it fits”What this feature needs to run (Requires).
flowchart TB
n_branding["branding"]
subgraph how_reqs["Requires"]
n_config["config"]
end
n_config --> n_branding
Dependencies
Section titled “Dependencies”- Requires:
config - Activation: always on (not toggleable)
Configuration
Section titled “Configuration”Per-tenant config keys, set via the tenant-admin UI or a seed. 🔒 = encrypted at rest.
| Key | Type | Default | Scope | Who can write | Who can read |
|---|---|---|---|---|---|
accent-color | text | "" | tenant | system, TenantAdmin, Admin, SystemAdmin | all |
custom-css | text | "" | tenant | TenantAdmin, Admin, SystemAdmin | all |
description | text | "" | tenant | system, TenantAdmin, Admin, SystemAdmin | all |
layout-preset | select (minimal | centered | wide) | centered | tenant | system, TenantAdmin, Admin, SystemAdmin | all |
logo-file | text | "" | tenant | system, TenantAdmin, Admin, SystemAdmin | all |
logo-url | text | "" | tenant | system, TenantAdmin, Admin, SystemAdmin | all |
site-url | text | "" | tenant | system, TenantAdmin, Admin, SystemAdmin | all |
title | text | "" | tenant | system, TenantAdmin, Admin, SystemAdmin | all |