Description
Huntsman Dark Mode Site Icon allows you to set a separate site icon for light and dark mode.
Upload one icon for light mode using WordPress’s built-in Site Icon, and upload a separate icon for dark mode using this plugin. The appropriate icon is then displayed automatically based on the visitor’s system theme.
No code or configuration is required. If no dark mode icon is set, WordPress behaves exactly as normal.
Key Features
- Separate site icons for light mode and dark mode
- Simple upload interface in the WordPress admin
- Works on the frontend, admin area, and login screen
- Optional enable/disable toggle
- Does not replace or override the core WordPress Site Icon
- Accessable via the WP API
Usage
-
Site Icon (WordPress)
This is the default WordPress Site Icon and is still managed by WordPress. -
Dark Mode Site Icon
This icon is only used when the user’s system is in dark mode and the browser supportsprefers-color-scheme.
If the Dark Mode Site Icon is not set, the plugin does nothing and WordPress behaves normally.
REST API
The plugin exposes a public REST endpoint for accessing the Dark Mode Site Icon:
/wp-json/hdmsi/v1/icons
Example response:
{
“enabled”: true,
“dark”: {
“id”: 123,
“url”: “https://example.com/icon-dark.png”
}
}
A dark-mode Web App Manifest is also available at:
/wp-json/hdmsi/v1/manifest?mode=dark
Screenshots
Visual overview showing how separate site icons are used in light and dark mode. 
Graphical representation illustrating how the Dark Mode Site Icon is applied across the frontend, admin area, and Site Editor. 
Example showing improved favicon visibility in light and dark mode, along with supported icon formats. 
Actual Dark Mode Site Icon settings screen in the WordPress admin, where the dark mode icon is uploaded and managed.
Installation
- Upload the
huntsman-dark-mode-site-iconfolder to the/wp-content/plugins/directory, or install via the WordPress plugin uploader. - Activate the plugin through the Plugins menu.
- Go to Settings Dark Mode Icon.
- Set your Dark Mode Site Icon.
- (Optional) Enable or disable output using the toggle.
FAQ
-
Does this replace the WordPress Site Icon?
-
No. The WordPress Site Icon remains the default. This plugin only adds additional dark-mode-specific tags.
-
What happens if I don’t set a Dark Mode Site Icon?
-
Nothing. The plugin outputs no additional tags and WordPress behaves exactly as normal.
-
Does this work in wp-admin and on the login screen?
-
Yes. The plugin outputs dark-mode favicon tags in the frontend, admin area, and login screen.
-
Does this support SVG icons?
-
Yes, but SVG uploads may be blocked by default in WordPress. You may need an SVG upload plugin.
-
What browsers support dark-mode favicons?
-
Most modern browsers support including recent versions of Chrome, Edge, Firefox, and Safari, but support can vary by platform and OS. If a browser does not support dark mode icons, the default WordPress Site Icon is used.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Huntsman Dark Mode Site Icon” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Huntsman Dark Mode Site Icon” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release
- Dark Mode Site Icon support
- prefers-color-scheme favicon output
- REST API and manifest support
- Admin, login, and frontend compatibility