Simple branding setup
Customize the appearance of SecureAuth web pages and messages using the built-in branding editor. You can easily update logos, fonts, and primary colors—without developer involvement.
Appearance changes apply to all workspaces in your tenant.
To apply branding per workspace or organization, use advanced Themes.
What you need
- Public Logo image URL
- Optional Font URL (e.g., Google Fonts)
- Brand Color codes (HEX, HSL, or RGB)
Access Branding settings
-
Go to Tenant Settings > Appearance.
-
Click the Branding tab.
Configure branding elements
Colors
Customize primary UI elements such as buttons and headers.
| Field | Description |
|---|---|
| Primary Color | Accent color for UI buttons/links |
| Header Color | Top nav and page headers |
You can:
- Select visually using the color picker
- Enter values in HEX, RGB, or HSL formats
Examples:
- HEX:
#1A73E8 - RGB:
rgb(26, 115, 232) - HSL:
hsl(217, 89%, 51%)
Logo
| Field | Description |
|---|---|
| Logo URL | HTTPS public URL of your logo (PNG, JPG, SVG supported) |
| Logo Size | Choose Small, Medium, or Large display size (default Medium) |
Recommended size: 200x60 pixels
Fonts
| Field | Description |
|---|---|
| Font URL | CSS link to font from CDN (e.g., Google Fonts) |
Examples:
- Google Fonts:
https://fonts.googleapis.com/css2?family=Roboto&display=swap - Custom CDN:
https://yourdomain.com/fonts/custom-font.css
Ensure your font source uses HTTPS and loads in all modern browsers.
Preview your changes
- Use the right-hand preview panel to see changes live
- Switch views between Login, Consent, MFA, and Error pages
Publish branding
Click Publish to apply branding across your tenant.
Changes affect all workspaces. For per-workspace theming, use advanced branding.
Summary of Branding Options
| Element | Affects | Options |
|---|---|---|
| Primary Color | Buttons, links | HEX, RGB, or HSL |
| Header Color | Headers/navigation | HEX, RGB, or HSL |
| Logo URL | Brand logo | HTTPS image (PNG, JPG, SVG) |
| Logo Size | Logo appearance | Small, Medium, Large |
| Font URL | Global text styling | Web font CSS (Google, Custom CDN) |
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| Logo not showing | URL invalid or blocked | Use valid HTTPS URL with correct format |
| Font not loading | HTTPS or CORS issue | Confirm URL works and browser-accessible |
| Colors not applied | Invalid format | Use proper HEX/RGB/HSL format |
| No visible changes | Browser cache | Try incognito or clear browser cache |