Theme and Branding
Choose the right branding guide for logos, admin theme, and learner-facing theme settings.
Use Settings > Appearance & Navigation > Theme & Branding to manage the visual identity of Built LMS for your organization.
This section has three separate jobs:
- Logo & Identity controls organization logos, favicon, and short logo text.
- Admin Theme controls the admin dashboard and shared admin UI surfaces.
- Learner Theme controls learner-facing pages, including learner dashboard, catalog, and course player surfaces.
These areas save differently. Logo uploads and logo text changes save directly to the organization record. Admin theme changes use the admin theme Save Changes action. Learner theme changes use the learner theme Save Changes action.
Before you begin
You need permission to update organization settings.
Before editing, prepare:
- A light-mode logo.
- A dark-mode logo if your light logo will not work on dark backgrounds.
- A square favicon.
- Brand colors with enough contrast for text and controls.
- A decision about whether learner pages should use the same visual direction as the admin dashboard or a separate learner experience.
Theme changes can affect many pages at once. Preview both light and dark mode before saving a theme that will be used broadly.
Open Theme & Branding
- Open Admin Dashboard > Settings.
- Open Appearance & Navigation.
- Select Theme & Branding.
The current page is /admin-dashboard/settings/organization/branding. Older
appearance and branding URLs redirect to this page.
Choose the right guide
| Goal | Use this guide |
|---|---|
| Upload logos, upload a favicon, or set short logo text. | Update Logo and Identity |
| Choose, edit, preview, save, duplicate, or delete an admin dashboard theme. | Configure the Admin Theme |
| Choose a learner theme recipe, edit learner colors or fonts, and preview learner pages. | Configure the Learner Theme |
| Configure the learner navbar, footer, and links. | Navigation |
| Edit the default page layout for learner detail pages. | Landing Page Templates |
Recommended brand update order
Use this order for most brand updates:
- Upload light logo, dark logo, and favicon in Logo & Identity.
- Confirm short logo text only if the product header needs it.
- Choose or create the admin theme.
- Set admin colors and typography.
- Preview the admin theme in light and dark mode.
- Save or apply the admin theme.
- Open Learner Theme.
- Choose the learner recipe.
- Override learner colors and typography only where needed.
- Preview learner light and dark mode.
- Save learner theme changes.
- Open learner-facing pages and confirm real course, catalog, and dashboard content still reads clearly.
Verify success
Theme and branding 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.
- The intended admin theme is marked active.
- Admin theme preview works in light and dark mode.
- Learner theme preview works in light and dark mode.
- Learner-facing pages use the selected learner recipe and overrides.
- Contrast warnings are resolved for important text and control pairs.
Troubleshooting
Use Logo & Identity for logos, favicon, and logo text. Use Admin Theme for admin dashboard colors, typography, spacing, radius, and shadows. Use Learner Theme for learner-facing pages.
Your account does not have permission to update settings. Ask an admin with settings write access to make the change or update your role.
Open preview in light and dark mode, then verify a real admin page and a real learner-facing page. Theme previews are useful, but live content can reveal wrapping, contrast, or density issues.