BugWP logo BugWP
Back to Community
Home / Community / General

Troubleshooting: Why Your WP Maintenance Mode Contact Form Isn't Working

16 threads Sep 10, 2025

Content

One of the most common issues users report with the 'LightStart – Maintenance Mode, Coming Soon and Landing Page Builder' plugin is a contact form or submit button that doesn't work as expected. The form might not submit, fail to show a confirmation message, or appear unresponsive. Based on community reports and solutions, this guide will help you diagnose and fix the problem.

Common Symptoms

  • The submit button does nothing when clicked.
  • Form data is received via email, but the user sees no on-screen confirmation.
  • A JavaScript error appears in the browser's console.
  • The form works on some devices or browsers but not others.

Why This Happens

The contact form relies on JavaScript to handle submissions asynchronously. If something interferes with this process—like a script error, a plugin conflict, or a server configuration issue—the form will fail to execute properly. The most frequent causes are JavaScript errors and conflicts with other plugins or themes.

How to Troubleshoot and Fix It

1. Check for JavaScript Errors

This is the most critical first step. JavaScript errors will prevent the form's script from running.

  1. Right-click on your maintenance page and select Inspect.
  2. Navigate to the Console tab.
  3. Reproduce the issue by filling out the form and clicking submit.
  4. Look for any red error messages in the console. These errors are the key to diagnosing the problem.

2. Clear Your Cache

If you've recently made changes to the plugin's settings or your site, your browser or a caching plugin might be serving an old, cached version of the page with outdated scripts. Clear your browser cache and any server-side or plugin-based cache (e.g., WP Rocket, W3 Total Cache).

3. Test for Plugin or Theme Conflicts

Another plugin or your theme could be causing a conflict.

  1. Temporarily deactivate all other plugins except WP Maintenance Mode.
  2. Switch to a default WordPress theme like Twenty Twenty-One.
  3. Test the contact form again. If it works, reactivate your plugins and theme one by one to identify the culprit.

4. Investigate Specific Error Messages

If you found an error in the console, it can point to a specific solution.

  • jQuery errors: An error mentioning jQuery is often due to it being missing or loaded incorrectly. This can sometimes happen after a WordPress update. The 'LightStart' team has noted this can be a hosting or installation-specific issue.
  • Cross-Origin (CORS) errors: An error mentioning 'Access-Control-Allow-Origin' indicates a problem where your 'www' and 'non-www' domain versions are conflicting. Ensure your WordPress Address and Site Address in Settings > General match exactly how your domain is being accessed.
  • Mobile-specific issues: One user found that on mobile devices, the modal contact form's 'Send' button was not visible. Their fix was to add the CSS rule overflow: auto; to the .contact class element. You can add custom CSS in the Customizer under Additional CSS.

5. Note on Shortcodes

The built-in form is the only one natively supported. If you are trying to use a shortcode from another form plugin like Contact Form 7, it will not work without custom development, as the maintenance mode page does not process those shortcodes by default.

What to Do If You're Still Stuck

If the above steps don't resolve your issue, you will get the best help from the community by providing specific details when you ask for help:

  • The exact error messages from your browser's console.
  • The URL of your maintenance page.
  • A list of the plugins you have active.

Providing this information will help others replicate the issue and suggest a targeted fix.

Related Support Threads Support