Docs
← Back to site

Light & Dark Mode

1 min readUpdated November 21, 2026

Readers can switch between a light and dark theme for your docs, with their choice remembered for future visits.

Turning it on#

Go to WP Super Docs → Settings → Appearance and turn on Show a light/dark mode toggle button in the topbar under Dark mode.

The Dark mode settings: the theme toggle and the default mode.

Choosing the default#

The Default mode dropdown controls what a first-time visitor sees, before they’ve made any choice of their own:

  • Auto (follows browser/OS setting): matches the reader’s own device preference.
  • Always light
  • Always dark

How the toggle behaves#

A doc page in dark mode.

Clicking the toggle button in the topbar switches between light and dark immediately, and that choice is saved in the reader’s browser. Once a reader has clicked it, their choice sticks on future visits, even if their OS-level preference changes afterward or you change the Default mode setting later. “Auto” only applies to readers who haven’t made an explicit choice yet.

What responds to the theme#

Beyond the overall color scheme, a few specific features are theme-aware:

  • Mermaid diagrams switch to a matching dark theme automatically. See Mermaid Diagrams in Docs.
  • Logos: if you’ve uploaded separate light and dark logos (see Customizing Colors and Branding), the correct one is shown automatically based on the current theme.

Was this helpful?

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only