Brand the applicant workflow

The applicant journey, the start interstitial, the completion page, and the invite email all render with your brand name and colors. This page covers customization at the workflow level: colors and brand name attached to a specific workflow template. For account-wide defaults, see Organization branding.

What can be customized

Workflow branding is a small, frozen set:

• Brand name: the heading on the start page and the salutation in the invite email.
• Primary color: required. Drives buttons, focus rings, and links.
• Secondary color: optional. Used for accents.
• Color mode: auto (operator-set, respects the system preference), light, or dark.

Values are validated as strict 6-digit hex (#RRGGBB) at the schema boundary, so a typo or a CSS injection attempt never reaches a rendered surface.

Logo and colors

Open the workflow at Dashboard → Workflows, then pick the workflow you want to brand. Toggle Customize branding for this workflow to enable the editor.

The editor offers preset palettes (Ocean, Forest, Plum) for the common cases, custom hex pickers for primary and secondary colors with a live preview, and a color-mode selector (auto / light / dark).

The live preview re-derives via the same deriveBrandTokens engine that the verify app and the email worker use, so what you see is what the applicant gets, with no drift. A non-blocking contrast warning chip appears when the chosen colors fail accessibility checks; you can ship anyway, but the chip is your nudge to reconsider.

Workflow branding sets colors and the brand name; the brand name carries the identity in the email, the start interstitial, and the completion page.

Custom support contact

Support contact is set at the organization level, and the applicant flow shows that contact. To change it, update your account-level support contact. See Organization branding.

Localization

The applicant flow is English-only. See Applicant language for the current language support.

Preview the workflow

The editor’s preview shows the applicant surface in both light and dark mode and a representative email layout. The email preview is light-only because outgoing emails always render light.

For a full walk-through, see What the applicant sees.

Workflow template overrides

Branding precedence at verification creation:

1. Workflow template branding: if the workflow template’s settings.branding has a primary color, it wins.
2. Organization branding: falls back to your account-level default.
3. Platform default: used when neither is set.

The brand name has its own precedence: the workflow template’s brand name wins independently of the color block, then the organization’s brand name, otherwise null. Resolution runs at verification creation and is frozen on the verification’s workflow snapshot. Changing the workflow template’s branding later does not retroactively rebrand a verification already in progress.

For terminology, see the Glossary.