Configure the Learner Theme
Choose a learner theme recipe, edit learner colors and fonts, and preview learner-facing pages.
Use Learner Theme for learner-facing pages. This tab controls the visual recipe, colors, and typography used by learner dashboard, catalog, course player, and related learner surfaces.
Learner theme settings are separate from the admin theme. Saving admin theme changes does not save learner theme changes.
Before you begin
You need permission to update organization settings.
Before editing, prepare:
- A learner-facing brand direction.
- Color choices with enough contrast for course cards, banners, and player UI.
- Font choices that work in the learner catalog and course player.
- Real learner-facing pages to check after preview.
Choose a learner theme recipe
In Learner Experience Theme, use the Theme selector to choose a recipe. Recipes provide the base learner palette, typography slots, spacing, radius, and decorative behavior for learner pages.
After choosing a recipe, edit only the overrides you need. The saved learner theme stores the selected recipe plus your overrides.
Edit learner colors and typography
Edit learner colors
Learner colors have light and dark palettes with these groups:
| Group | Tokens |
|---|---|
| Core | Background, foreground, card, card foreground, muted, and muted foreground. |
| Semantic | Primary, secondary, accent, destructive, success, warning, info, and their foreground colors. |
| UI Elements | Border and focus ring. |
| Charts | Chart 1 through Chart 5. |
Contrast warnings appear inline. Treat them as blockers for learner-facing themes because they affect readability in the catalog, course cards, banners, and course player UI.
Edit learner typography
Learner typography shows the font slots declared by the selected recipe. A recipe can expose display, sans, serif, and mono slots.
Use typography overrides when the default recipe font does not match your brand or causes learner-facing pages to wrap poorly. If a font change is only needed for admin dashboard readability, make that change in Admin Theme instead.
Save and preview the learner theme
Save learner theme changes
When learner theme edits are unsaved, the header shows Unsaved.
Use:
- Reset to discard unsaved learner theme edits.
- Save Changes to save the selected recipe and overrides.
- Preview to open the learner theme preview sheet.
Saving validates the override. Invalid color paths, unknown font families, or custom fonts that do not belong to the organization are rejected.
Preview learner-facing pages
Select Preview from the learner theme header to open Learner Theme Preview.
The preview includes light and dark mode toggles and learner-facing examples such as:
- A featured learner page hero.
- A course card.
- A certificate callout.
- A learner announcement banner.
Use this preview to check the learner experience before you update the live learner theme. After saving, open real learner-facing pages and confirm course, catalog, and dashboard content still reads clearly.
Verify success
The learner theme is ready when:
- 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.
- Course cards, banners, and course player screens remain readable.
- Font choices do not cause awkward wrapping or cramped learner content.
Troubleshooting
You may not have settings write permission, or there may be no unsaved learner theme changes.
Check recent color and font changes. Learner theme saves validate known color paths, known Google font families, and organization-owned custom font IDs.
Learner theme settings are separate from the admin theme. If the two surfaces should match, choose a learner recipe and overrides that intentionally mirror the admin theme.