Troubleshooting Ninja Forms: Fixes for Common Problems

Your form worked fine yesterday. Today the notification emails have stopped, the Submissions page is empty, or the form just sits there spinning (if it shows up at all). Ninja Forms not working, someone waiting on those messages, and no idea whether the issue is the plugin, your theme, your host, or one of the other plugins you updated last week?

So you search, and the results throw everything at you at once. Deactivate your plugins, switch themes, install an SMTP plugin, call your host… half of it is years old, and none of it tells you how to troubleshoot these issues without breaking a live site.

Yes, it’s frustrating. But it’s also fixable. This guide to troubleshooting Ninja Forms takes the most common issues one symptom at a time, with the quickest, safest check first, and tells you what each result means and how to solve the issue from there.

Ninja Forms not working? Start with these three checks

Most Ninja Forms issues come down to something out of date, an old cached copy of the page, or a compatibility issue with your theme or other plugins. Run these three checks first, in this order, whatever your symptom. The first two are safe on a live site, and the third can run without your visitors noticing.

1. Update everything. Go to Dashboard > Updates and update Ninja Forms, its add-ons, your other plugins, your theme and WordPress. If you have a staging copy of your site, update there first.
2. Clear every cache. Clear your caching plugin, your host’s cache and any CDN, then load the form page in a private browser window.
3. Run the compatibility test. It’s the single most useful way to troubleshoot plugin conflict issues, and it’s laid out in section 1 below.

Still not working? Find your issue and jump straight to it:

• Plugin conflict and compatibility issues
• Ninja Forms not sending email
• Can’t download Ninja Forms submissions
• Ninja Forms submissions not showing or blank
• reCAPTCHA not working on your WordPress form
• Ninja Forms not displaying on the page
• What to send our support team

Every check on this page was confirmed against Ninja Forms 3.15 and WordPress 7.1 in October 2026.

1. Plugin compatibility issues: how to find the plugin or theme causing a conflict

A compatibility issue happens when your theme or one of your other plugins gets in the way of Ninja Forms, and it’s one of the most common reasons you’ll find Ninja Forms not working. The fix is to switch everything else off, confirm the form works, then switch things back on one at a time until the issue returns. The last plugin (or theme) you switched on is your culprit.

Sounds drastic? It’s not, as long as your visitors aren’t watching.

Run the compatibility test on a staging copy, or for your login only

A staging copy of your site is the best place to troubleshoot, because switching off plugins there doesn’t touch the live site. Many hosts can create one for you from the hosting dashboard.

No staging copy? The Health Check & Troubleshooting plugin has a Troubleshooting Mode that turns off your plugins and switches to a default theme for your login only, while visitors keep seeing the normal site. It works on current WordPress, but the plugin’s listing hasn’t been updated since mid-2024, so staging is the steadier choice when you have one.

Either way, the compatibility test is the same four steps:

1. Deactivate all plugins except Ninja Forms and its add-ons. (In Troubleshooting Mode they start switched off; enable Ninja Forms from the Troubleshooting Mode menu in the admin bar.)
2. Switch to a default WordPress theme, such as Twenty Twenty-Five.
3. Test the form: submit it, check for the email, and check Submissions.
4. If it works, switch your plugins back on one at a time, then your theme, testing after each, until the issue comes back.

When the issue comes back, you’ve found the plugin or theme behind the conflict. Look for a setting there that will solve it, ask its developer, and let our support team know what you found.

Theme issues? Our docs on styling your forms explain how Ninja Forms works with themes.

In Troubleshooting Mode, click Disable Troubleshooting Mode when you’re done; settings you changed along the way are kept. Testing on the live site with neither option? Pick a quiet moment, because visitors see the default theme and the missing plugins while you test.

Look at caching, optimization and security plugins first

Not sure which of your plugins to suspect? Start here. Caching and speed plugins that combine, delay or minify scripts cause more than their share of compatibility issues, because Ninja Forms builds your form on the page with JavaScript.

Exclude your form pages from caching and script optimization, then clear the cache. Security plugins and host firewall rules can block a form’s requests too; our page on mod_security rules covers what to ask your host.

If your form submits but hangs on processing, with the button spinning forever, here’s how to fix a form that won’t finish processing.

Check your WordPress and PHP versions

Old software causes compatibility issues of its own. As of October 2026, Ninja Forms needs WordPress 6.9 or newer and PHP 7.4 or newer. WordPress itself recommends PHP 8.3 or greater and calls 7.4 end of life, so if your site still runs it, a PHP update is worth a chat with your host.

To see what your site runs, go to Tools > Site Health > Info. Remember that page; it comes in handy if you contact support.

2. Ninja Forms not sending email? Here’s how to find where it stops

When Ninja Forms is not sending email, the issue sits somewhere between your form and the inbox. Ninja Forms hands each email to WordPress, WordPress hands it to your host (or a sending service), and the host delivers it. Find the step where it stops and you’ve found your fix.

Most email issues are quick to track down once you know where to look. Think of it like tracking a package. You don’t need to know how the truck works, just the last place the package was scanned.

Make sure the email action is switched on

Open your form (Ninja Forms > Dashboard, then click the form) and click the Emails & Actions tab. Your email action’s toggle should be on (green). Click the action and check that To holds a real address and Subject isn’t blank, then click Publish if you changed anything.

Setting up a notification from scratch? Here’s how to get notified when someone submits a WordPress form.

Check the mail log to see whether WordPress got the email

This is the check that saves the most time. Install the WP Mail Logging plugin, submit your form, then open WP Mail Logging from your admin menu. It records every email that reaches wp_mail(), the part of WordPress that sends email.

Here’s what you’ll see, and what it means:

• An entry with your subject line, recipient and time. Ninja Forms did its job and handed the email to wp_mail(). The issue is past WordPress, with delivery.
• No entry at all. Ninja Forms is not sending the email to WordPress in the first place. Recheck the email action above, then run the compatibility test from section 1.
• An entry showing errors. The error message is your best clue, so copy it for your host or our support team.

Email in the log but not in the inbox? It’s a delivery issue

Check your spam folder first. Then talk to your host, because once wp_mail() has the email, Ninja Forms has no more say in whether it arrives; sending it is your host’s job.

If your host can’t sort it out, an SMTP plugin or a transactional email service is the next step, and SendWP, our own sending service, is one option. A service dedicated to sending email is almost always an upgrade over a host that handles email as one job among many.

Our email action troubleshooting guide goes through every setting on the action, and our docs on sending email and improving email deliverability cover the rest. Want the bigger picture? The Definitive Guide to WordPress Email follows emails from your form to the inbox.

Once your emails are flowing again, here’s how to resend the notification emails you missed.

3. Can’t download Ninja Forms submissions?

To export your submissions, go to Ninja Forms > Submissions, choose your form under Select a form, and click Download All Submissions. You get one CSV file with a column for each field. If you see “Submissions download failed” instead, the export request ran into errors on your server.

That message can come from a few different issues, so work through the usual suspects:

• Other plugins, your theme or a security rule blocking the request. Run the compatibility test from section 1, and see our mod_security page if your host runs a firewall.
• A very large export. Lots of submissions can run past your server’s memory or time limits, and your host can raise those.
• Out-of-date software. Update Ninja Forms and its add-ons, and check WordPress and PHP against the requirements in section 1.

Need your data in a different shape? Here’s more on exporting WordPress form submissions.

4. Ninja Forms submissions not showing or blank? Check Record Submission first

If your form sends its emails but the Submissions page stays empty, check the form’s Record Submission action first. With it switched off, the form still submits, shows its success message and sends every email, but nothing is saved to your site. Of all the issues on this page, it’s one of the easiest to fix: one toggle.

Switch Record Submission back on

Open your form, click the Emails & Actions tab (pictured in section 2 above), and make sure the Record Submission toggle is on. Click Publish.

New submissions are saved from then on. Anything sent while it was off was never stored, so the notification emails are your only copy of those.

Choose your form on the Submissions page

The Submissions page stays blank until you pick a form. Go to Ninja Forms > Submissions and choose yours under Select a form.

Page blank or won’t load? Run the compatibility test, then try the legacy page

If the Submissions page itself is blank or won’t load, run the compatibility test from section 1, because a conflict with another plugin is the usual cause.

While you track it down, you can switch to the older Submissions page as a temporary workaround for these issues. Go to Ninja Forms > Settings, scroll to Advanced Settings, turn on Show Legacy Submissions Page and save. Refresh the settings page, then open Submissions again.

If you need the legacy page, let our support team know so we can help solve the underlying issue.

5. reCAPTCHA not working on your WordPress form

Most reCAPTCHA issues come down to the keys: a domain that doesn’t match the one registered with Google, a key for the wrong version, or two versions on one form. Your keys live in Ninja Forms > Settings, in the reCaptcha Settings section, with separate boxes for v2 and v3.

How to fix it when reCAPTCHA is not working on your form?

Match the errors you’re seeing to one of these:

• “ERROR for site owner: Invalid domain for site key.” The domain registered for your key in Google’s reCAPTCHA admin console doesn’t match your site. Add your site’s domain there to fix it.
• reCAPTCHA doesn’t show up at all. That usually means an invalid key, or a key for the wrong version (a v2 key in the v3 boxes, or the other way round). Copy fresh keys from Google into the matching boxes.
• Both versions on one form. Your site can have keys saved for both versions, but use only one version on any one form.

Want the step-by-step? Here’s why reCAPTCHA isn’t working on your WordPress form, with fixes for the common errors, and our reCAPTCHA docs cover setup.

Moving to v3? Here’s how to add reCAPTCHA v3 to your WordPress form.

Visitors seeing a “please leave it empty” field?

Every Ninja Forms form has a hidden honeypot field that only bots fill in. Its label reads “If you are a human seeing this field, please leave it empty,” and visitors only see it when the Ninja Forms stylesheet doesn’t load, usually because CSS optimization or a plugin conflict removed it. If someone fills it in anyway, the form shows “Honeypot Error” and won’t submit.

Exclude the Ninja Forms styles from your optimization plugin, clear the cache, and the field disappears again. Here’s more on the spam protection built into Ninja Forms.

6. Ninja Forms not displaying on the page? Here’s how to fix it

When Ninja Forms is not displaying a form, it’s usually one of two issues: the form isn’t on the page, or its scripts aren’t loading. A form area that shows only a spinning loading icon, with no fields, means something, usually a caching or optimization plugin, blocked the Ninja Forms scripts. A form not displaying at all, with no spinner, usually means it isn’t embedded the way you think.

Check that the form is on the page

Edit the page and look for the Ninja Forms block in the WordPress editor, or a [ninja_form id=X] shortcode with your form’s ID in place of the X. The Shortcode column on Ninja Forms > Dashboard shows the right one for each form, and our guide to publishing a form covers every way to add one.

Spinner but no fields? Let the scripts through

If caching or optimization plugins delay, combine or remove the Ninja Forms scripts, the fields never appear. Exclude those scripts (or the whole page) from script optimization, clear every cache and reload, and if it still spins, run the compatibility test from section 1.

Form stuck in maintenance mode after an update?

If a form is still unavailable after an update, go to Ninja Forms > Settings, scroll to Advanced Settings, and click Remove Maintenance Mode.

Still stuck? Here’s what to send our support team

Worked through the checks above and your form is still not working? Contact our support team. The more you include in your first message, the more useful our first reply can be.

Send these four things:

1. Your versions of Ninja Forms, its add-ons, WordPress and PHP, plus your active plugins and theme. Tools > Site Health > Info has them all, and its Copy site info to clipboard button grabs everything at once.
2. The exact error message, or a screenshot of it.
3. The steps that make the issue happen.
4. What you’ve tried to solve it so far, especially your plugin compatibility test and mail log results.

Get your form working again, one check at a time

Like we said at the top, form issues are frustrating, but they’re fixable. Test one thing at a time, start with the cheapest check, and when a result points past WordPress, take it to your host or to our support team with the details above.

You don’t need to be a developer to troubleshoot Ninja Forms issues. You just need to know where to look, and now you do. Bookmark this page, and when you want the detail on any setting, dig into the Ninja Forms documentation.