BugWP logo BugWP
Back to Community
Home / Community / Plugin → Maintenance

Troubleshooting Guide: Why Your Maintenance Page Logo or Background Isn't Showing

21 threads Sep 16, 2025 Plugin → Maintenance

Content

One of the most common issues users encounter with the Maintenance plugin is that their custom logo or background image fails to display on the maintenance page. Instead, they might see a default placeholder image, a blank screen, or a 'Mad Designer at Work' cartoon. This guide will walk you through the most frequent causes and their solutions, based on community support threads.

Why This Happens

Several factors can prevent your images from loading correctly. The Maintenance plugin is designed to work with a minimal set of resources to ensure a clean, error-free maintenance screen. This means it often blocks scripts and styles from other plugins and themes, which can sometimes conflict with how images are loaded. The most common culprits are other plugins, caching, or specific plugin settings.

Common Solutions

1. Check for Plugin Conflicts (Especially Lazy Load & Optimization)

This is by far the most common cause. Image optimization plugins that use 'lazy loading' often inject code that expects JavaScript to function. Since the Maintenance page prevents most external scripts from running, this lazy load code fails, and the images never load.

  • How to fix it: Temporarily disable any image optimization, lazy load, or caching plugins (e.g., Smush, 10Web Booster). Clear your browser and site cache, then check if the images appear. If they do, you've found the conflict. You can re-enable the plugins one-by-one to identify the specific one, keeping the problematic feature disabled while Maintenance mode is active.

2. Upload Both a Standard and a Retina Logo

In newer versions of the plugin, a feature was added to support high-resolution Retina displays. If you only upload a standard logo, the code may incorrectly reference a default image file for the high-resolution version.

  • How to fix it: Navigate to Maintenance > Settings (or Settings > Under Construction). Ensure you have uploaded an image to both the Logo and the Retina Logo fields. Even if you don't have a dedicated high-resolution logo, uploading the same image to both fields often resolves the issue.

3. Clear All Caches

Caching mechanisms, including browser cache, server cache, and plugin-based cache (like from a CDN or optimization plugin), can serve an old version of your maintenance page without the newly configured images.

  • How to fix it: After making any changes to your Maintenance settings, clear all relevant caches. This includes pressing Ctrl+F5 (Cmd+Shift+R on Mac) to hard-refresh your browser and clearing any caching plugins you have active on your site.

4. Verify You Are Using the Correct Settings Page

Some users have reported confusion because there can be multiple places to configure settings. The primary settings are typically found under Settings > Under Construction. Ensure you are making your changes in the correct location to avoid confusion.

5. Check Your Image Format and URL

While the plugin supports common web formats like JPG, PNG, and GIF, using an SVG for the background has been known to cause issues. Also, double-check that the image URL generated by the plugin is correct and that the image exists at that location.

  • How to fix it: Use JPG or PNG files for backgrounds. For the logo, right-click on the broken image on your maintenance page, select 'Inspect', and check the 'src' attribute of the image tag. See if the URL looks correct and try visiting it directly in your browser.

What to Do If Nothing Works

If you have tried all the steps above and your images still won't display, the next step is a full conflict test.

  1. Temporarily disable all other plugins except Maintenance.
  2. Switch your theme to a default WordPress theme like Twenty Twenty-One.
  3. Check if the images now load. If they do, re-enable your plugins one-by-one until the issue returns, which will identify the conflicting software.

By methodically working through these common issues, you should be able to resolve most problems with images not displaying on your Maintenance page.

Related Support Threads Support