Light & Dark Mode
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.

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#

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?
Thanks for your feedback!
✓ Feedback received. Thank you!