Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Troubleshooting

WPForms Submit Button Not Working: Causes and How to Fix It

WPForms Submit Button Not Working: Causes and How to Fix It

Short answer

The WPForms submit button usually fails because a JavaScript error or script delay stops WPForms running, a hidden required field blocks validation, a CAPTCHA check fails, or a firewall blocks the AJAX request. Check the browser console first, then exclude WPForms from optimisation.

Key takeaways

  • Check the browser console and Network tab before anything else.
  • Script delay and combine options are a frequent cause.
  • Hidden required fields silently block submission.
  • Wrong CAPTCHA keys or cached tokens stop submissions.
  • A 403 on admin-ajax points to a firewall or security rule.

Why is the WPForms submit button not working?

The WPForms submit button usually fails because a JavaScript error or delayed script stops WPForms from running, a hidden required field blocks validation, a CAPTCHA or anti-spam check fails, or a security rule blocks the AJAX request.

The symptom tells you a lot. A button that does nothing at all points to JavaScript.

A button that spins forever points to the server. A button that shows an error points to validation or spam protection.

Start by testing the form in a private window while logged out. Caching and script optimisation often affect visitors differently from logged-in admins.

If the form does not appear at all, that is a different problem. See WPForms not loading instead.

How do you narrow down the cause?

Match what happens when you click Submit to a likely cause: nothing happening, an endless spinner, an error message or a page reload each point to a different fix.

What happensLikely causeFirst fix
Nothing at allJavaScript error or delayed scriptsCheck the console, exclude WPForms from delay
Spinner never stopsAJAX request blocked or server errorCheck firewall and PHP errors
Error under a fieldValidation, often a hidden required fieldFix conditional logic or field settings
CAPTCHA errorWrong keys or blocked CAPTCHA scriptRecheck keys and domain settings
Anti-spam or token errorOld cached pageClear cache, exclude form pages
Page reloads, no entryNon-AJAX submit with a conflictTurn on AJAX submit and retest

Open your browser's developer tools before clicking Submit. The Chrome DevTools Console guide shows how to read errors, and the Network tab shows whether the request was sent.

Is a JavaScript error stopping the button?

Yes, this is the most common cause: if any script on the page throws an error before WPForms runs, or WPForms scripts are delayed or combined incorrectly, the submit button cannot work.

Look in the Console tab for red errors. The file name in each error often reveals the plugin or theme responsible.

WPForms has a guide to the JavaScript not loading properly error that lists the usual culprits.

Common sources include:

  • Caching plugins that delay, defer or combine JavaScript.
  • Theme scripts with errors.
  • Other plugins loading an old jQuery or conflicting libraries.
  • Themes that do not call the footer function, so WPForms scripts never load.

Is script delay or caching breaking the form?

Optimisation features like Delay JavaScript, Defer JavaScript and Combine JavaScript often break WPForms, so exclude WPForms scripts from those features or turn them off for form pages.

In WP Rocket, add WPForms to the exclusion list for Delay JavaScript execution. Our guide on WP Rocket delay JavaScript exclusions shows the exact field.

Other optimisation plugins have similar settings. Look for options named delay, defer, combine or minify JavaScript, and add WPForms or jQuery to their exclusion lists.

After changing settings, clear every cache layer and test in a private window again.

Is a hidden required field blocking submission?

A required field that is hidden by conditional logic, placed on another page of a multi-page form, or styled out of view can block submission, so check required fields and their logic.

When validation fails, WPForms shows an error next to the field. If that field is hidden, you never see the message and the button seems dead.

  1. Open the form in the WPForms builder.
  2. Check each required field, especially ones with conditional logic.
  3. Make sure hidden fields are not required, or that the logic shows them when needed.
  4. Check fields on other pages of a multi-page form.
  5. Save and test again.

Custom CSS can also hide fields. Inspect the form on the front end to see whether anything is set to display none.

Are CAPTCHA or anti-spam checks failing?

reCAPTCHA, hCaptcha or Turnstile can block submission when keys are wrong, the domain is not registered or the CAPTCHA script is blocked, and the WPForms anti-spam token can fail on old cached pages.

For CAPTCHA problems:

  • Confirm the site key and secret key match the provider and the CAPTCHA type.
  • Make sure your domain is listed in the provider's settings.
  • Exclude CAPTCHA scripts from delay and combine options.

Our guide to WPForms reCAPTCHA not working covers each provider in detail. For Turnstile, Cloudflare's Turnstile documentation explains domain and key setup.

WPForms also uses a built-in anti-spam token. If a page stays cached for a long time, that token can expire and submissions fail. Shorten cache lifespan or exclude form pages from caching.

Review your options in WPForms spam protection settings.

Is the AJAX request being blocked?

When the button spins without finishing, the AJAX request to WordPress is usually blocked by a firewall, security plugin or server rule, or the server returns a PHP error.

WPForms explains this in its guide to the Ajax submit error.

In the Network tab, click Submit and look for a request to admin-ajax.php. Check its status:

  • 403: a firewall or security plugin blocked it.
  • 500: a PHP error happened on the server.
  • No request at all: JavaScript stopped before sending.

For 403 errors, check security plugins, Cloudflare WAF rules and your host's ModSecurity settings. Our guide on Cloudflare WAF rules for WordPress covers the Cloudflare side.

For 500 errors, turn on logging using the WordPress debugging guide and read the error.

Is the button hidden or covered by another element?

Sometimes the button works but cannot be clicked because a transparent element covers it, its colour matches the background, or theme CSS hides it on certain screens.

Right-click the button and choose Inspect. If the inspector highlights a different element, something sits on top of the button.

Popups, sticky headers and cookie banners are common culprits. Adjust their position or z-index in custom CSS.

If the button is invisible, check its colours in the form builder's styling settings or your theme's button styles.

Could a plugin or theme conflict be the cause?

Yes, conflicts are common, so test on a staging copy with all plugins except WPForms deactivated and a default theme active, then reactivate items one by one to find the culprit.

  1. Create a staging copy or use a maintenance window.
  2. Deactivate every plugin except WPForms.
  3. Switch to a default WordPress theme.
  4. Test the form.
  5. Reactivate plugins one at a time, testing after each.

Our plugin conflict guide has a fuller process, including the Health Check plugin's troubleshooting mode.

What if the form submits but nothing arrives?

If the form submits successfully but no email arrives, the button is fine and the problem is email delivery, which needs SMTP setup and notification checks instead.

Check WPForms > Entries first if your licence stores entries. If entries exist, the form works.

Then follow how to fix WPForms not sending email to fix notifications.

Which fixes solve most WPForms submit problems?

Most cases are fixed by excluding WPForms from script delay and caching, fixing hidden required fields, correcting CAPTCHA keys, and allowing AJAX requests through security rules.

Work in that order. Each step rules out a common cause before you spend time on rarer ones.

Keep WPForms, WordPress and your other plugins updated. Many submit bugs are fixed in routine releases.

Frequently asked questions

Why does my WPForms button do nothing when clicked?

A button that does nothing usually means JavaScript is not running. Another script may have an error, or a caching plugin may be delaying WPForms scripts. Check the browser console for errors and exclude WPForms from script delay.

Why does WPForms keep spinning after I click submit?

An endless spinner means the request reached WordPress but failed or was blocked. Look in the Network tab for admin-ajax requests returning 403 or 500, then check firewall rules, security plugins and PHP error logs.

Can caching stop WPForms from submitting?

Yes. Long-lived cached pages can carry expired anti-spam tokens, and delay or combine JavaScript options can stop form scripts. Exclude form pages and WPForms scripts from these features, then clear all caches.

Why does WPForms submit work for me but not visitors?

Logged-in admins often bypass caching and script optimisation, so they see a working form while visitors get cached or delayed versions. Test in a private window while logged out to reproduce what visitors see.

Does WPForms need AJAX submission turned on?

No, but AJAX submission avoids page reloads and is useful in popups. If a form fails with AJAX on, the request is often blocked. If it fails with AJAX off, check for conflicts and validation problems.

Sources

  1. Error: Ajax Submit Error WPForms
  2. Error: JavaScript Not Loading Properly WPForms
  3. Console overview Chrome for Developers
  4. Turnstile documentation Cloudflare
  5. Debugging in WordPress WordPress Developer Resources

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.