Built LMS Help Center
Settings

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:

GroupTokens
CoreBackground, foreground, card, card foreground, muted, and muted foreground.
SemanticPrimary, secondary, accent, destructive, success, warning, info, and their foreground colors.
UI ElementsBorder and focus ring.
ChartsChart 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

On this page