Admin Dark Mode

Admin Dark Mode is a free WordPress plugin that adds a minimal moon/sun switch to the right end of the admin bar and to the block editor header.

Features

• Minimal moon and sun icons with no floating panel or text label
• One-click dark mode across WordPress admin screens
• Dedicated control in the block editor header
• Accessible labels and pressed-state announcements
• Browser-local preference that persists across reloads and synchronizes between tabs
• Original colors preserved for images, videos, and canvases
• No settings screen, account, tracking, or external dependencies

Requirements

• WordPress 6.0 or newer
• PHP 7.4 or newer
• A modern browser with CSS mask support

Installation

1. Download admin-dark-mode-1.8.0.zip from the latest GitHub release.
2. In WordPress, open Plugins > Add New > Upload Plugin.
3. Select the ZIP, install it, and activate Admin Dark Mode.
4. Select the moon icon at the right end of the admin bar or in the block editor.

You can also clone this repository into wp-content/plugins/admin-dark-mode.

How it works

The plugin applies a color inversion to the admin document and counter-inverts media so photographs and videos retain their original colors. The selected mode is stored only in the browser's local storage under wpDarkMode; no preference or usage data is sent to WordPress or any external service.

Development

The production source is maintained in the coded-letter-monorepo and released to this public repository. The plugin has no build step.

Validate JavaScript changes with:

node --check assets/admin-dark-mode.js

Validate PHP changes with:

php -l admin-dark-mode.php

License

Admin Dark Mode is free software licensed under the GNU General Public License v2.0 or later.