Skip to main content
Skip to content

Dark mode for courses

How to give a course theme a dark version, what learners see, and how they switch between light and dark.

How do I add dark mode to my courses?

Turn on Light and dark mode for a theme in your Brand kit. Learners then see the dark version of that theme when their device is set to dark, and the light version when it isn't. Coassemble generates the dark colours from your light ones, and you can change any of them. Dark mode is for courses built in the new builder.

How do I turn on light and dark mode for a theme?

  1. Open Brand kit from your courses dashboard, or select Themes in the course builder and then Brand kit.
  2. Go to Themes. Open an existing theme with Edit, or select Create theme.
  3. In the Colours section, switch on Light and dark mode. A new theme starts with it on.
  4. Check the Preview, which has a Light and a Dark view, and change any colours you want to.
  5. Select Save theme.
  6. Publish the courses that use the theme so learners see the change.

An existing theme stays light only until you switch the mode on, so turning it on for one theme doesn't change your other themes or the courses that use them.

What dark colours does a theme get?

When the mode is on, the Colours section shows two columns, Light and Dark, for Accent, Background and Headings.

  • Generated colours: content screens get a deep shade of your accent as their background. Buttons and other controls keep your accent. If your light background is already dark, it stays as it is.
  • Headings: a headings colour that doesn't read on the dark background goes back to Auto, so the text picks whichever of dark or white reads.
  • Start and Finish screens: they keep the same colours in light and dark.
  • Your own dark colours: change any field in the Dark column and your colour is used instead of the generated one. Select Use the generated colour again on a field to go back.

In the Logo section, switch on Display logo and choose a logo for Light mode. With light and dark mode on, a second picker, Dark mode logo, lets you choose a logo that reads clearly on a dark background. It is set to Same as light until you pick one, so learners see your light logo on dark screens.

If Bounding box is on, learners see the light logo on its white box, in both modes. If the dark logo can't load, learners see the light one.

The dark logo comes from your logos in the Brand kit, so upload it in the Logos section first.

What do learners see, and how do they switch?

Courses follow each learner's device setting by default. A learner whose device is in dark mode sees the dark colours and dark logo, and everyone else sees the light ones.

Learners can also choose for themselves. In the course outline, an Appearance button sits beside Finish. It opens a menu with three options:

  • Match device: follow the device setting.
  • Light: always show the light version.
  • Dark: always show the dark version.

The choice shows straight away and is remembered on that learner's device, for every course. The Appearance button only appears in courses whose theme has light and dark mode on.

In the course builder, the editor and the theme thumbnails always show the light version. Use the Preview in the theme editor to see the dark one.

How do I check my dark colours are readable?

The Review tab (Course Coach) measures the colours learners see in light mode and, when the theme has light and dark mode on, in dark mode too. It warns you when:

  • your accent is hard to see in dark mode
  • your headings are hard to read in dark mode
  • a screen's background hides its buttons and progress dots in dark mode
  • hand-picked text colours don't read on the dark background

A warning about the theme has an Open theme button that takes you to that theme in the Brand kit. A warning about a screen's background has Pick for me, which chooses a background that works, and Edit background, which opens that screen's background so you can choose yourself.

Light and dark themes also carry a small half-filled badge on their thumbnail in the Themes menu, so you can tell them apart from light only themes.

Does dark mode work in SCORM exports?

Yes. SCORM packages keep the theme's light and dark colours, so learners in your LMS see the version that matches their device, and can switch with Appearance like everywhere else.

Where is dark mode not available?

Classic courses and collections have no dark version. The Light and dark mode switch doesn't appear when you edit a theme from a Classic course or a collection, those courses and collections always show light colours, and a collection's email gate page stays light.

Frequently asked questions

Will turning on dark mode change my published courses?

Saving a workspace theme updates every course that uses it, and the window tells you how many courses that is. Learners see the dark version once you publish those courses again.

Can learners turn dark mode off?

Yes. They choose Light from Appearance in the course outline, or Match device to follow their device again.

Can I use different fonts in dark mode?

No. Dark mode changes colours and the logo. Fonts stay the same.