Organization branding lives at **Settings → Branding**. The values here are the default brand for every applicant flow and every transactional email sent on behalf of the organization.

This page covers organization-level branding. Workflow template overrides for the applicant flow are documented separately. See [Workflow branding](/guides/workflows/workflow-branding).

## What gets branded

The organization branding record stores:

- **Primary color** — the dominant brand color used for buttons, links, and accents.
- **Secondary color** — an optional accent used alongside the primary.
- **Color mode** — `auto`, `light`, or `dark`. `auto` follows the recipient's system preference.

Colors must be 6-digit hex values (for example, `#2563eb`). The form rejects anything else before it reaches the server.

## Set the colors

1. Open **Settings → Branding**.
2. Pick a preset palette or open the color picker and choose your own primary, optional secondary, and color mode.
3. Click **Save**. The page surfaces a success or error message.

Only **Owner** and **Admin** can change branding. Other roles see a notice and the editor is hidden; the API rejects the call server-side as well.

## Preview before you save

The editor renders a live preview of the colors against the standard applicant UI so you can see contrast and the light / dark modes before persisting. Saving overwrites the organization's stored branding; the next applicant flow and the next outbound email pick it up immediately.

## Troubleshooting

- **"Could not load saved branding" notice.** A stored branding value was malformed. The editor falls back to defaults so you can save a fresh, valid record. The previous bad value is replaced once you save.
- **The Save button does nothing.** You have not yet picked a color. Choose a preset or set a primary color first.
- **Applicant flow still shows the old colors.** Open an incognito window or reload after clearing cache. Applicant browser caches sometimes hold the previous palette until reload.

## Related

- [Workflow branding](/guides/workflows/workflow-branding): workflow template overrides for the applicant flow
- [Glossary](/glossary)