Back to Community
Home / Community / Plugin → Maintenance

Troubleshooting Maintenance Plugin Login Issues: A Comprehensive Guide

33 threads Sep 16, 2025 Plugin → Maintenance

Content

If you're using the Maintenance plugin and find yourself locked out of your WordPress site or unable to log in through its frontend form, you're not alone. This is a common issue reported by many users. This guide will walk you through the most frequent causes and their solutions, helping you regain access to your site.

Why Do Login Problems Occur with the Maintenance Plugin?

Login issues typically stem from conflicts. The Maintenance plugin creates its own login form, which can interfere with other plugins that modify WordPress's default authentication or security processes. Based on community reports, the most common culprits are:

  • CAPTCHA/reCAPTCHA Plugins: Plugins like "No CAPTCHA reCAPTCHA" or other security tools that add a CAPTCHA field to the standard login form. The Maintenance plugin's form does not include this field, causing logins to fail even with correct credentials.
  • Two-Factor Authentication (2FA) Plugins: Plugins like Duo that change the default login flow or URL. The Maintenance plugin uses the default login path, creating a conflict.
  • Custom Login URL Plugins: Plugins that change the default wp-login.php slug to something else (e.g., /login or /my-secret-backdoor).
  • Membership or Custom Login Plugins: Plugins like Ultimate Member that manage frontend user logins.
  • Caching: Aggressive page caching can sometimes serve a cached version of the maintenance page, preventing the login form from functioning correctly.

How to Regain Access and Fix the Problem

Follow these steps to troubleshoot and resolve the login issue.

Step 1: Bypass the Maintenance Login Form

Your first goal is to access your WordPress dashboard. Since the problem is often with the frontend form, try logging in through the standard WordPress login URL.

  1. Go to your website's direct login page by appending /wp-login.php to your site's URL (e.g., https://yourwebsite.com/wp-login.php).
  2. If this works, you have confirmed the issue is isolated to the Maintenance plugin's frontend login. Proceed to the next steps to fix it.
  3. If the standard login page also redirects you back to the maintenance page, you likely have another plugin (like a security plugin) that has changed your login URL. You may need to use your web host's file manager or FTP to temporarily rename the Maintenance plugin's folder (located in /wp-content/plugins/) to maintenance-off. This will deactivate the plugin and restore normal site access, allowing you to log in.

Step 2: Identify and Resolve the Conflict

Once you are logged in, you can work on a permanent solution.

For CAPTCHA/2FA Conflicts:
The Maintenance plugin's official stance, as seen in multiple support threads, is that it does not currently support CAPTCHA or reCAPTCHA integration in its frontend login form. Your options are:

  • Disable the Conflicting Plugin: Temporarily deactivate your CAPTCHA or 2FA plugin while your site is in Maintenance mode.
  • Use the Standard Login URL: If you must keep Maintenance mode active, instruct authorized users to log in directly via /wp-login.php.
  • Disable Frontend Login: In the Maintenance plugin's settings, uncheck the "Enable frontend login" option. This will remove the login form from your maintenance page, forcing all logins through the standard WordPress URL.

For Custom Login URL Conflicts:
If you use a plugin that changes your login URL, you have two choices:

  • Temporarily disable the custom login URL plugin while using Maintenance mode.
  • Use the actual custom URL (e.g., /my-login) to access your dashboard instead of the Maintenance form.

Step 3: Clear Your Cache

If you use a caching plugin or server-level cache, clear it entirely after making any changes to the Maintenance plugin's settings. A stale cache could be serving an old version of the page without your updates.

What About the "Lost Password" Link?

Some users have reported issues with the "Lost Password" link not working correctly or being misplaced. Older versions of the plugin had a bug where this link was malformed, but this was reportedly resolved. If you encounter this problem:

  • Ensure your Maintenance plugin is updated to the latest version.
  • If the link's design or placement is poor, you can hide it using custom CSS. Add the following code to the "Custom CSS" box in the Maintenance plugin's settings: a.lost-pass { display: none !important; }

Conclusion

Login problems with the Maintenance plugin are almost always due to a conflict with another security or login-related plugin. The most reliable solution is to bypass the frontend login form and use the standard wp-login.php URL. If you must use the frontend form, you will likely need to deactivate conflicting plugins temporarily. Always remember to clear your cache after making changes to ensure they take effect immediately.

Related Support Threads Support