Update Logo and Identity
Upload organization logos, favicon, and short logo text.
Use Logo & Identity when you need to update organization-level assets. This section is collapsed by default inside Theme & Branding.
Logo uploads and logo text changes save directly to the organization record. They are not controlled by the admin theme Save Changes button.
Before you begin
You need permission to update organization settings.
Prepare:
- A light-mode logo.
- A dark-mode logo if your light logo will not work on dark backgrounds.
- A square favicon.
- Optional short logo text.
Open Logo & Identity
- Open Admin Dashboard > Settings.
- Open Appearance & Navigation.
- Select Theme & Branding.
- Open Logo & Identity.
Update brand assets
Upload logos
There are two logo slots:
| Logo slot | Use |
|---|---|
| Logo (Light Mode) | Used when the application is in light mode. |
| Logo (Dark Mode) | Optional logo for dark mode, recommended when the light logo loses contrast on dark backgrounds. |
Logo files can be PNG, JPG, WebP, or SVG. The maximum size is 5 MB. SVG uploads are sanitized before use.
To update a logo:
- In Logo (Light Mode) or Logo (Dark Mode), upload the file.
- Wait for the upload to finish.
- Confirm the success message.
- Refresh another admin or learner page if you need to confirm the updated logo outside the settings page.
Upload a favicon
The favicon appears in browser tabs and bookmarks.
Favicon files can be PNG, ICO, or SVG. The maximum size is 0.5 MB. The image must be square and between 16x16 and 512x512 pixels.
To update the favicon:
- Upload the favicon file in Favicon.
- Wait for the success message.
- Refresh the browser tab if the old favicon is still cached.
Set logo text
Use Logo Text when you want short text displayed next to the logo.
Rules:
- Maximum length is 10 characters.
- Letters, numbers, spaces, hyphens, and periods are allowed.
- The Display switch is disabled when the text is empty or invalid.
Logo text auto-saves after you stop typing. It does not wait for the theme save action.
Verify success
Logo and identity settings are ready when:
- The correct logo appears in light mode.
- The dark logo is readable in dark mode.
- The favicon appears after refreshing the browser tab.
- Logo text appears only when Display is enabled.
- A real admin page and learner-facing page show the expected branding.
Troubleshooting
Your account does not have permission to update settings. Ask an admin with settings write access to make the change or update your role.
Refresh the page. Logo and favicon assets can be cached by the browser or by components that loaded before the asset changed.
Logo text must be non-empty and valid. Keep it to 10 characters or fewer and use only letters, numbers, spaces, hyphens, and periods.