Description
DarkAdmin transforms the WordPress admin dashboard into a clean, eye-friendly dark interface. The plugin is purely CSS-based, keeping it fast and non-intrusive. All colors are driven by CSS custom properties, making the theme fully customizable through a dedicated settings page — no code editing required. An optional Auto Dark Mode feature uses JavaScript to dynamically handle third-party plugin areas not covered by the built-in stylesheet.
Features:
* One-click enable/disable
* Lightweight CSS-based admin theme
* Works across all admin pages
* Individual color customization via WordPress Color Picker
* Custom CSS support using built-in CSS variables
* Token-based design system for backgrounds, text, borders, buttons and states
* Auto Dark Mode: automatically darkens bright plugin backgrounds not covered by the stylesheet
* Preset Themes: Modern (WP 7.0, default) and Classic (WP 6.x) color palettes
* Plugins: optional dark styles for Yoast SEO, Wordfence, UpdraftPlus, WP-Optimize, Contact Form 7, Complianz, Newsletter, Duplicator, Spectra, WPBakery Page Builder, Elementor, Polylang, Fluent Forms, JetEngine, WP Rocket, and WordPress AI & Connectors
* Per-user Dark Mode access control (Include / Exclude) with empty-state UI when no non-admin users exist
* Excluded Pages: specify admin pages where dark mode should not be applied
* Dark Block Editor (optional, WordPress 7.1+): dark post/page block editor interface; the editing canvas turns dark when “Use theme styles” is turned off, or always with “Darken Theme Design in the Editor”
* Dark Site Editor (optional): dark site editor interface, while the site preview keeps the theme design
* Dark Login Page (optional): dark wp-login.php in the active palette
* Excluded Plugins: turn dark mode off for every admin page of selected plugins
Installation
- Upload the plugin folder to
/wp-content/plugins/darkadmin-dark-mode-for-adminpanel/(or install via the Plugins screen). - Activate the plugin through the “Plugins” screen in WordPress.
- Go to Settings > DarkAdmin and enable it.
FAQ
Does this affect the frontend?
No. It only loads CSS in wp-admin.
Where are the settings?
Settings > DarkAdmin
Can I customize the colors?
Yes. The plugin includes multiple color pickers for the complete admin theme and also supports additional custom CSS.
Who can edit the Custom CSS?
Users who can access Settings > DarkAdmin and have the WordPress edit_css capability. On multisite this is normally limited to super administrators. Other administrators can still change the remaining DarkAdmin settings without overwriting the stored CSS.
What is Auto Dark Mode?
An optional second toggle that uses JavaScript to dynamically darken bright backgrounds and lighten dark text from third-party plugins not covered by the built-in stylesheet. Requires Dark Mode to be active.
Does it work in the block editor?
Yes, on WordPress 7.1 or later, when “Dark Block Editor” is enabled under Settings > DarkAdmin. The editor interface turns dark right away. If your theme has its own editor styles, the editing area keeps your theme’s design as a preview until you turn off “Use theme styles” in the editor (Options > Preferences > Appearance); then it turns dark too. If your theme has no editor styles, the editing area is dark even with “Use theme styles” on. To get a dark editing area while keeping theme styles on, also enable “Darken Theme Design in the Editor”. The site editor (Appearance > Editor) has its own “Dark Site Editor” setting; its preview of your site design is never recolored.
Can I turn dark mode off for a specific plugin?
Yes. Under Settings > DarkAdmin > Advanced > “Excluded Plugins”, check the plugin. DarkAdmin finds all admin pages that plugin registers on its own, including subpages that add-ons place in its menu (for example MainWP and its extensions), so you do not have to list every admin.php?page=… URL.
Can the login page be dark too?
Yes, enable “Dark Login Page” under Settings > DarkAdmin. It applies to everyone who opens wp-login.php.
Screenshots

























Changelog
0.7.0
- Added: Dark styles for WPBakery Page Builder: backend editor, Add Element, Edit Element, Templates, Page Settings and Custom CSS & JS panels, frontend editor toolbar, Grid Builder and settings screens
- Added: Dark styles for Elementor admin screens (Home, Settings, Tools, System Info, Role Manager, Templates, Submissions and more). The Elementor editor keeps its own UI theme setting.
- Added: Dark styles for Polylang: Languages, Translations and Settings screens, language and flag pickers, term translation fields
- Added: Dark styles for Fluent Forms: forms list, form editor, form settings, entries, reports, global settings, tools and integrations, including a dark editing area for confirmation messages and email bodies
- Added: Dark styles for JetEngine screens and the Crocoblock dashboard
- Added: Dark styles for Settings > WP Rocket
- Fixed: Field labels on the Add Category / Add Tag forms were unreadable, and unchecked checkboxes and radio buttons stayed white
- Fixed: Excluded Plugins keeps a stored exclusion when the plugin is temporarily inactive
- Fixed: Plugin page detection no longer attributes pages to the wrong plugin when plugins share or nest folders
- Developers: New darkadmin_plugin_is_installed filter to override the plugin detection for the plugin styles
0.6.0
- Added: “Dark Site Editor” setting (off by default): dark site editor interface (navigation, Pages, Templates and Patterns lists, Styles panel, editor interface). The preview of your site design keeps the theme colors.
- Added: “Dark Login Page” setting (off by default): dark wp-login.php using the active palette, with the white WordPress logo instead of the default logo
- Added: “Excluded Plugins” (Settings > DarkAdmin > Advanced): turn dark mode off for all admin pages of selected plugins, including hidden pages and add-on subpages in the plugin’s menu
- Fixed: The picked color of the WordPress color picker no longer shows through around the “Select Color” label and stays in the swatch on hover
- Fixed: The opened color picker appears below its button again instead of being cut off next to it
- Fixed: The color picker swatch on the settings page shows the full picked color
- Fixed: The layout shadow field accepts valid CSS such as calc() and rejects values that could break the inline stylesheet
- Fixed: Users who always get dark mode (manage_options, super admins) are no longer listed in the User Access picker
- Fixed: Palette imports reject JSON without a known color instead of reporting a successful import
- Fixed: The dark login page only replaces the default WordPress logo, never custom logos
- Fixed: Custom CSS textarea and Excluded Plugins list are labeled for screen readers
- Maintenance: GitHub Actions pinned to commit SHAs; new workflow to update WordPress.org assets without a release
- Maintenance: All screenshots retaken on WordPress 7.1, plus new screenshots of the site editor, the login page and the Excluded Plugins setting
0.5.0
- Added: “Dark Block Editor” setting (off by default): dark post/page block editor interface (header, sidebars, inserter, list view, block toolbar, menus, modals, publish panel). The editing area turns dark when “Use theme styles” is turned off or the theme has no editor styles. The site editor stays excluded. Requires WordPress 7.1 or later.
- Added: “Darken Theme Design in the Editor” setting (off by default): the editing area also turns dark while “Use theme styles” is on
- Changed: Removed unused Gutenberg rules from the main stylesheets, which made the block editor copy the whole admin stylesheet into the editor canvas
- Fixed: Custom CSS capability is enforced on every options.php save route
- Fixed: Plugin-style settings keep their current format when an old migration is retried
- Fixed: The dark settings body class is only added when the dark stylesheet is loaded
- Fixed: Settings toggle switches have accessible text for screen readers
- Fixed: Block editor breadcrumb root link is readable in dark mode
- Developers: New darkadmin_block_editor_supported filter to override the WordPress version check
- Maintenance: The Plugin Check Trunk workflow passes wp-version: trunk and no longer duplicates the stable Plugin Check run
0.4.1
- Added: Dark mode for Appearance > Fonts (font-library.php, WordPress 7.0+): library, upload and Google Fonts install tabs, font cards, footer bar and readable font previews
- Added: darkadmin-wpds.css with shared dark styles for WordPress Design System screens (Fonts, Connectors, AI plugin screens), loaded automatically
- Changed: Custom CSS is editable only by users who can access Settings > DarkAdmin and have the edit_css capability; other settings saves keep the stored CSS
- Fixed: Settings > Connectors and Settings > AI were light on WordPress 7.1
- Fixed: About, Credits, Freedoms, Privacy and Get Involved screens, striped list rows and the classic Publish box footer
- Fixed: Updated dark styles for Spectra, Newsletter, Yoast SEO, Wordfence, Duplicator, UpdraftPlus, WP-Optimize (incl. the new onboarding wizard) and Complianz
- Fixed: Hardened option reads, Custom CSS sanitizing on output, non-scalar allowed-user entries and color picker defaults after switching presets
- Fixed: Uninstall also removes settings notice transients and per-site options on multisite
- Maintenance: “Tested up to” is declared only in readme.txt; release ZIP excludes build/ and release-notes.md
0.4.0
- Added: Dark mode styles for Complianz, Newsletter, Duplicator and Spectra; listed in Settings > DarkAdmin > Plugins and enabled automatically when the plugin is active
- Added: 14 new screenshots (presets, plugins, posts, comments, users, Complianz, WooCommerce, Yoast SEO, Newsletter, Duplicator)
- Fixed: Yoast SEO light search button, active sidebar item and promo card in the modern admin UI
- Compatibility: Updated for WordPress 7.1 with dark styling for current WordPress components, including modals, popovers, cards, notices, menus, inputs, and native dialogs
- Compatibility: Dark mode now covers the Classic Editor on post.php and post-new.php; block-editor instances and the Site Editor remain intentionally excluded
- Maintenance: Composer PHP requirement now matches the plugin’s existing PHP 8.0 minimum
- Updated translation files for the new plugin style descriptions
0.3.2
- Fixed: WordPress AI & Connectors page header (admin-ui Page) — title and subtitle are readable in dark mode; styles load after wp-components
0.3.1
- Added: Dark mode styles for WordPress AI & Connectors (Connectors screen, AI plugin settings, Connector Approvals, AI Request Logs)
- Added: wordpress-ai.css with WPDS token remapping; auto-loads on matching admin screens when dark mode is active
- Added: Plugin registry entry WordPress AI & Connectors in Settings > DarkAdmin > Plugins
- Updated translation files for 0.3.1 strings
0.3.0
- Added: Plugins settings section with optional dark styles for Yoast SEO, Wordfence, UpdraftPlus, WP-Optimize, and Contact Form 7
- Added: Plugin-specific CSS in assets/css/plugins/ (uses your –adm-* color tokens)
- Modern preset is now the default for new installations (WP 7.0 design language)
- Renamed “Default” preset to “Classic” (WP 6.x dark theme)
- Existing installations keep the Classic preset after upgrade
- Preset reset buttons renamed to “Restore Preset Layout” / “Restore Preset Colors”
- Settings saved notice uses a per-user transient instead of $_GET query parameters
- JavaScript UI strings load exclusively via darkadminI18n (no English fallbacks)
- Updated translation files for all 0.3.0 strings
- Fixed: Dark Mode and Auto Dark Mode toggles can now be turned off reliably
- Fixed: Live color preview uses correct CSS variable names
- Fixed: Color/layout sanitization respects the active preset
- Classic preset: sidebar color pickers now apply via
--adm-sidebar-*tokens - Modern preset: added missing Thickbox modal and plugin-install-tab styles
- Tested up to WordPress 7.0
0.2.2
- Fixed Plugin Details dialog footer color
0.2.1
- Lowered minimum WordPress version requirement from 6.7 to 6.3
- Dark mode styles for Thickbox modal (plugin details dialog): background, text, links, buttons and close button fully themed via
--adm-*variables - Fixed theme overlay header navigation buttons (
.theme-overlay .theme-header .left/.right/.close): applied background, color andborder: noneusing--adm-*variables in bothdarkadmin-dark.cssanddarkadmin-wp-modern.css - Fixed
#contextual-help-backbutton styling: background, border and color now use--adm-*tokens in both CSS presets - Fixed: consolidated duplicate
darkadmin_get_preset_fallbacks()definition and inline fallback helper functions indefaults.phpandenqueue.phpinto single canonical helpers - Fixed: removed unused
$presetsvariable inenqueue.phpadmin_enqueue_scriptscallback - Fixed: misplaced
<!-- .adm-preset-layout -->HTML comment insettings-page.php(was on inner preview panel</div>instead of outer.adm-preset-layout</div>) - Fixed: moved
translators:comment outsidesprintf()onto the line directly above__()so PHPCSWordPress.WP.I18n.MissingTranslatorsCommentdetects it correctly (settings-page.php)
0.2.0
- Raised minimum WordPress version to 6.7
- Raised minimum PHP version requirement to 8.0 (already required by existing use of str_starts_with, str_contains and named arguments)
- Added defer loading strategy to darkadmin-settings-js and darkadmin-auto-darken via the strategy argument introduced in WordPress 6.3
- Fixed: replaced inline echo ‘
- Fixed: replaced anonymous arrow function sanitize callbacks in register_setting() with named functions darkadmin_sanitize_bool(), darkadmin_sanitize_user_ids() and darkadmin_sanitize_preset()
- Fixed: used strict boolean check (true === $value) instead of loose cast in darkadmin_sanitize_bool()
- Fixed: removed direct $_POST access in darkadmin_sanitize_colors() and darkadmin_sanitize_layout(); preset value now read from $input array
- Fixed: added shadow_md value validation against a safe CSS pattern in darkadmin_sanitize_layout()
- Fixed: added late escaping via wp_strip_all_tags() to both wp_add_inline_style() calls for $vars and $custom
- Fixed: renamed generic JS object names admData and admI18n to darkadminData and darkadminI18n in enqueue.php and settings.js
- Added i18n string “Copied!” to enqueue.php via wp_localize_script (darkadminI18n.copied)
- Fixed: replaced hardcoded ‘Copied!’ string in settings.js initVarCopy() with darkadminI18n.copied for full translateability
- Fixed: replaced innerHTML with textContent in initVarCopy() to prevent potential XSS
- Updated all language files (.pot, de_AT, de_DE, en_US): added Copied! / Kopiert! translation, bumped version to 0.1.3, updated timestamps
- Fixed: added missing @package DarkAdmin tag to darkadmin.php file comment
- Fixed: add_filter() and add_action() calls in darkadmin.php now comply with WPCS multi-line function call rules (opening parenthesis last on line, one argument per line, closing parenthesis on its own line)
- Fixed: equals sign alignment for $has_users in settings-page.php (7 spaces expected)
- Fixed: closing PHP tag not on its own line in settings-page.php ($prev assignment block)
- Fixed: opening PHP tag not on its own line in settings-page.php ($current_color block)
- Fixed: replaced short ternary ?: with explicit isset() check and full ternary for $current_color in settings-page.php
- Fixed: incorrect indentation in settings-page.php (10 tabs expected, 9 found)
- Fixed: Yoda conditions for all comparisons in settings-page.php
- Fixed: replaced inline control structure with braced block in settings-page.php
- Fixed: replaced $_GET[‘page’] with get_current_screen() in enqueue.php to avoid direct superglobal access
- Fixed: added current_user_can() capability check at the top of darkadmin_settings_page() in settings-page.php
- Fixed: added missing darkadmin_layout option cleanup in uninstall.php
- Fixed: proper UTF-8 umlauts in readme-de.txt (replaced ASCII substitutions with correct characters)
- Fixed: replaced escaped HTML entity checkmark with literal UTF-8 character in preset button (settings-page.php)
0.1.2
- Added dedicated Sidebar color group with three new tokens: Sidebar Background (–adm-sidebar-bg), Sidebar Active Item (–adm-sidebar-active) and Sidebar Text (–adm-sidebar-text)
- Added sidebar token translations to all language files (de_AT, de_DE, en_US, .pot, .l10n.php)
- Added layout token system (spacing, radius, shadow) with per-preset defaults and settings UI
- Unified layout tokens across presets, added layout JS handlers, updated all language files
- Added .adm-layout-grid CSS: 4-column grid with responsive breakpoints and dark mode overrides
- Improved color picker swatch display in settings page
- Fixed translators comment and phpcs:ignore placement in settings-page.php
- Fixed: replaced & HTML entity with literal UTF-8 ampersand in i18n strings (settings-page.php)
- Fixed: replaced PHP \u2713 escape with literal UTF-8 checkmark character in admin notice strings
- Fixed: replaced ✓ HTML entity with literal UTF-8 checkmark in preset button PHP and all .po files
- Fixed: replaced ASCII-escaped umlauts with proper UTF-8 characters in all language files, added missing msgids (checkmark Active, em-dash in admin notice)
- Updated darkadmin-dark.css and darkadmin-wp-modern.css
0.1.1
- Fixed uninstall.php: corrected all option names from wrong adm_ prefix to darkadmin_ prefix so options are properly removed on plugin deletion
0.1.0
- Added support for excluded pages in settings
- Added user access control (include/exclude users)
- Added preset themes (default and modern)
- Fixed critical JS bugs in preset and reset functionality
- Fixed missing closing brace in initPaletteIO() importFile block in settings.js
- Fixed XSS vulnerability in printf output (settings-page.php)
- Fixed Unicode escapes in language files: replaced \uXXXX sequences with literal UTF-8 characters
- Added admI18n JS localization via wp_localize_script for translated UI strings
- Removed redundant wp-color-picker script enqueue
- Added .l10n.php language cache files for all locales (de_AT, de_DE, en_US) with ABSPATH protection
- Added hex validation for JSON palette imports
- Updated documentation for new features
0.0.10
- Extended Themes section: added dark styling for .theme-browser .theme .theme-name, .theme-overlay .theme-actions, .theme-overlay .theme-tags, .theme-overlay .theme-header .theme-title, .theme-overlay .theme-author, .theme-overlay .theme-version and .theme-overlay .theme-rating .star-rating .star
- Added Theme Editor / Template Side section: dark styling for #templateside > ul, .importer-title and .color-option.selected / .color-option:hover
- Reduced .cm-error background opacity from .15 to .05 for a more subtle error highlight in CodeMirror
- All changes applied to both darkadmin-dark.css and darkadmin-wp-modern.css
- Fixed invalid control sequences in all language files (de_AT, de_DE, en_US, .pot): replaced \uXXXX Unicode escapes with literal UTF-8 characters to resolve msgfmt compilation errors
- User Access: Include and Exclude options are now greyed out and non-clickable when no non-administrator users exist (disabled radio input + CSS pointer-events: none)
- User Access: replaced plain text fallback with a styled empty-state block (centered layout, dashed border, large icon)
- i18n: added missing string “No non-administrator users found. Create additional users to manage their dark mode access here.” to .pot, de_AT, de_DE and en_US language files
0.0.9
- Added Preset Themes: choose between Default (WP 6.x classic dark) and Modern (WP 7.0 deep blue, glassmorphism-inspired) color palettes
- Each preset ships with its own CSS file (darkadmin-dark.css / darkadmin-modern.css) loaded dynamically based on the active preset
- Added adm_preset option with live preset switching on the settings page
- Added per-user Dark Mode: administrators always have dark mode, non-admin users can be individually enabled via a new User Access card
- Added live color preview: color picker changes update CSS variables instantly without saving
- Added Export / Import palette as JSON file
- Added custom CSS sanitizer (adm_sanitize_custom_css) — preserves valid CSS while stripping dangerous HTML/PHP tags
- Added CSS cache-busting based on md5 hash of current color values
- Refactored plugin into modular includes: defaults.php, user-settings.php, enqueue.php, settings-page.php
- Added uninstall.php to clean up all options on plugin removal
- Color pickers now grouped by category (Backgrounds, Surfaces, Borders, Text, Links, Brand, CodeMirror) on the settings page
- Expanded color tokens from 23 to 34 (new: bg_bar, bg_deep, bg_darker, table_alt, plugin_inactive, border_hover, text_on_primary, link_hover, primary_hover, cm_keyword-cm_bracket)
0.0.8
- Fixed invisible text in .widefat tables (update-core.php and similar pages): override WP core rule
.widefat ol, .widefat p, .widefat ul { color: #2c3338 }with dark theme color token
0.0.7
- Added version to darkadmin-dark.css header comment
0.0.6
- Updated Text Domain from darkadmin to darkadmin-dark-mode-for-adminpanel to match the wordpress.org plugin slug
- Updated Plugin URI to https://wordpress.org/plugins/darkadmin-dark-mode-for-adminpanel/
- Updated all language files (.po, .pot) to new text domain
0.0.5
- Rebranded plugin from “WP Admin Dark Mode” to “DarkAdmin – Dark Mode for Adminpanel”
- Renamed main plugin file from wp-admin-dark-mode.php to darkadmin.php
- Renamed CSS file from wp-admin-dark.css to darkadmin-dark.css
- Updated text domain from wp-admin-dark-mode to darkadmin
- Updated all language files (de_AT, de_DE, en_US, .pot) to new darkadmin text domain
- Updated settings menu slug from wp-admin-dark-mode to darkadmin
- Updated plugin folder reference in readme to /wp-content/plugins/darkadmin/
0.0.4
- Added Auto Dark Mode option: optional JS-based pass that dynamically darkens bright backgrounds and lightens dark text from unknown plugins using WCAG luminance calculations
- Auto Dark Mode uses a MutationObserver to also handle AJAX-loaded content
- Fixed color picker swatch visibility: removed background-color from .wp-color-result in CSS so WP’s inline style shows the swatch correctly
- Updated all translation files (de_AT, de_DE, en_US, .pot) with new Auto Dark Mode strings
0.0.3
- Full CSS overhaul with a token-based design system for backgrounds, surfaces, borders, text, links, buttons and semantic states
- Added new customizable color variables:
surface1,surface2,surface3,text_softanddanger - Increased the number of adjustable color tokens from 9 to 13
- Fixed the Add Plugin / page title action button styling so text stays readable in dark mode
- Fixed the WordPress Color Picker button styling by preserving the inline swatch background and styling only the text section
- Improved spacing, sizing and proportions to better match native WordPress admin UI defaults
- Extracted the settings page styles into a dedicated assets/css/settings.css file
- Reworked the settings page layout for cleaner spacing and more consistent component styling
- Improved plugin list styling, row actions, tables, notices, form controls, dashboard elements and navigation tabs
- Removed unwanted colored shadows / blue row highlight artifacts in plugin tables
0.0.2
- Redesigned settings page with card-based layout, page header with status badge and version display
- Added individual color customization for 9 dark mode colors via WordPress Color Picker
- Added “Restore Default Colors” button to reset all colors to the WordPress sidebar palette
- Added Custom CSS editor field to inject additional styles after the dark mode stylesheet
- All dark mode colors are now driven by CSS custom properties (–adm-bg, –adm-card, etc.)
- Base background color changed to #1d2327 (native WordPress sidebar color)
- Fully optimized dark mode CSS: Admin Bar, Sidebar, Buttons, Forms, Tables, Notices, Gutenberg, Media, Screen Options, Dashboard Widgets
- Settings page itself adapts to dark mode when active
0.0.1
- Initial development release.
