2. Troubleshooting

Most Darkify issues come down to one of three things: a cache holding an old stylesheet, an element that needs excluding, or a colour that needs pinning. Work through this page, and you will resolve the large majority of them yourself.

Start here #

1. Clear every cache. Your caching plugin, your host’s cache, your CDN, then your own browser with a hard refresh (Ctrl+Shift+R / Cmd+Shift+R).
2. Check in a private window. This rules out your own browser extensions and stored preferences.
3. Confirm the settings are saved. Reopen the screen and check that the values are what you expect.
4. Check the version. The Darkify version sits under the logo in the sidebar. Compare it with the changelog.

Dark mode is not appearing at all #

The floating switch is not visible #

• Check Hide on desktop and Hide on mobile under Switches → Floating Switch. If both are on, no switch appears anywhere.
• Check whether the current page is restricted — on a restricted page, the switch is hidden by design.
• Look for something covering it: a cookie banner, chat widget, or sticky bar. Raise the Switch Offset or move it to a different corner.
• If your theme uses a very high stack order, the switch can end up underneath it. A single line in Normal Mode CSS fixes that:.darkify_switch_wrapper { z-index: 99999; }

Some text is unreadable in dark mode #

This happens where a theme or builder sets a colour with high specificity. In order of preference:

1. Adjust the text colour in Colors → Preset if it affects the whole site.
2. Pin that specific colour in Color Overrides if it is one colour used in several places.
3. Target the element in Custom CSS if it is one component.

My logo disappears #

A dark logo on a dark background. Two good fixes:

• Best: upload a light version and map it under Media → Image Controls → Replace Images.
• Quick: add the logo URL to Invert Specific Images.

A section looks broken #

Usually a third-party widget or a section already designed dark. Add its selector to Disallowed Elements under HTML/CSS Restriction, with * to include its children:

.booking-widget *, #pricing-table *

Images look washed out or too dark #

Lower the Brightness Level and Greyscale Level under Media → Image Controls, or add the specific images to the exclusion lists. On a shop, exclude your product images entirely.

The page flashes white before going dark #

Nearly always an aggressive optimisation plugin deferring or combining Darkify’s script. In your optimisation plugin, exclude Darkify’s JavaScript from deferral and from “combine JS”. Then clear all caches.

Dark mode works on the frontend but not in wp-admin #

• Turn on Admin Panel Dark Mode under Controls → Admin.
• Check that the page slug is not listed under Disallowed Pages on that same screen.
• Remember it is a per-user preference — use the toggle in your admin bar.

Settings will not save #

• Raise a low PHP max_input_vars — ask your host, or add max_input_vars = 3000 to php.ini. Large custom CSS blocks are the usual trigger.
• A security plugin or mod_security rule may be blocking the request. Check its logs.
• Open your browser console (F12) while saving and note any error; include it if you contact support.

A conflict test that takes five minutes #

1. Work on a staging copy if you have one.
2. Deactivate every plugin except Darkify. Check the problem.
3. Still broken? Switch to a default theme such as Twenty Twenty-Four. Check again.
4. Fixed? Reactivate plugins one at a time until the problem returns — that plugin is the conflict.
5. Send us the name of the plugin or theme. We resolve most reported conflicts in the next release.

Starting over #

If a configuration has drifted, export a backup from Tools for safety, then use the reset option in the three-dot menu to return a section to its defaults and rebuild from there.

Still stuck? #

Contact support with your page URL, a screenshot, your theme and builder, and your settings export. Most tickets are answered within one business day.