Branding

Logo, colors, careers page theming, candidate journey copy, and transactional email footer settings.

Settings → Branding (/dashboard/settings/branding) controls how candidates and external viewers experience your employer brand. Changes autosave after a short debounce (700 ms) once required fields validate.

Admin access required (canManageOrganization).

Branding configuration sections

The branding editor is organized into four areas stored in the org's branding config:

1. Logo & identity

Field	Purpose
Logo URL	Primary logo on careers page, journey header, and some emails
Favicon URL	Browser tab icon on careers and candidate surfaces
Company name	Display name when logo is unavailable

Uploads use presigned S3 URLs (trpc.upload.getPresignedLogoUrl, getPresignedFaviconUrl) with confirmation step. Supported formats follow standard web image types.

2. Colors

Token	Used on
`primary`	Buttons, links, careers hero accent
`secondary`	Secondary actions, badges
`accent`	Highlights, progress indicators
`text`	Body copy on branded surfaces
`background`	Page background on careers and journey

The editor includes preset swatches (InsightHire teal default and common brand palettes) plus custom hex inputs. Careers page and public job listings read colors.primary and logo.logoUrl from this config — see insighthire-api/src/routers/careers.ts.

Quick-select presets include Teal (#48D597), Blue, Purple, Orange, and custom entry.

Field	Purpose
From name	Display name on outbound candidate/recruiter emails
Support email	Reply-to and footer contact (must be valid email to save)
Custom footer	HTML/text appended to transactional templates

Journey invitation, reminder, and completion emails merge branding tokens from this section. Org-level Mailgun routing is configured separately at /admin/email-settings.

4. Candidate experience copy

Field	Purpose
Welcome message	Shown when a candidate starts a journey
Completion message	Shown after journey submission
Support message	Help text with support contact guidance
Show company branding	Toggle branded chrome vs minimal UI
Custom CSS	Optional stylesheet injected on candidate-facing pages (Enterprise)

Preview modes (Desktop / Mobile) help validate layout before publish.

Careers page branding

While Settings → Careers manages URL, domain, and listing behavior, visual theming comes from Branding:

Careers hero and job cards inherit primary color and logo
Custom domain SSL is configured on the Careers page, not Branding

Configure both pages before go-live:

Branding — logo, colors, candidate copy
Careers — slug, custom domain, which positions are public

White-label and plan limits

Full white-label (custom CSS, minimal InsightHire chrome) is included on Enterprise plans. Starter and Professional plans still get logo and color customization on standard templates.

Check Settings → Billing for your plan's featuresIncluded list.

Autosave behavior

Edits debounce to a single trpc.branding.update call
Invalid support email blocks save and shows inline error
Reset to defaults restores InsightHire baseline branding via trpc.branding.reset
Upload success shows a transient toast; config autosaves on URL update

Where branding appears

Surface	Branding fields used
Public careers page	Logo, primary color, company name
Candidate journey	Welcome/completion copy, logo, colors, custom CSS
Email templates	From name, support email, custom footer, logo
Review queue / dashboard	Minimal — internal UI uses InsightHire shell

Best practices

Use a horizontal logo with transparent background (PNG or SVG)
Keep primary color contrast ≥ 4.5:1 against white for WCAG AA on careers CTAs
Set support email to a monitored inbox (hiring@, recruiting@)
Test mobile preview — most candidates complete journeys on phone
After major rebrand, send a test journey invite to verify email rendering

Settings overview — Careers tab path
Notifications — email template editing
Billing — Enterprise white-label