Troubleshooting
Ninja Forms Not Working: Causes and How to Fix It

Short answer
Ninja Forms usually breaks because of a JavaScript conflict, a caching or script optimisation plugin, or a security rule that blocks form requests. Check the browser console and network tab, turn off script delay and combining, run a conflict test, and review firewall logs.
Key takeaways
- Most Ninja Forms problems come from JavaScript errors.
- Script delay and combining features often break forms.
- Stuck on processing means the AJAX request failed.
- Firewalls can block submissions with a 403 error.
- Submissions need the Store Submission action turned on.
- Use SMTP so form emails actually arrive.
Why is Ninja Forms not working?
Ninja Forms usually stops working because of a JavaScript conflict, a caching or script optimisation plugin, a security rule blocking form requests, or a theme that does not load scripts correctly.
Ninja Forms is a popular drag-and-drop form builder. Its forms rely heavily on JavaScript, both in the builder and on the front end, so script problems cause most failures.
Symptoms vary. The form may not appear, the submit button may spin on processing forever, the builder may not load, or submissions may vanish.
This guide covers each symptom and its causes in order. If your only problem is missing emails, our dedicated guide on Ninja Forms not sending email goes deeper on mail delivery.
What are the common Ninja Forms problems at a glance?
Most Ninja Forms issues fit a handful of patterns, and each has a likely first check.
| Symptom | Likely cause | First check |
|---|---|---|
| Form does not display | JavaScript error, wrong shortcode, theme issue | Browser console, shortcode ID |
| Stuck on processing | AJAX request blocked or erroring | Console and network tab |
| Builder will not load | Plugin conflict or outdated add-on | Conflict test, update add-ons |
| Submissions not saved | Save action missing or database issue | Form actions list |
| Emails not arriving | Mail delivery from the server | Set up SMTP |
| Layout broken | Theme CSS or optimisation plugin | Disable CSS combining |
Pick the row that matches what you see, then read the section below.
Why is the form not showing on the page?
A missing form usually means the shortcode or block points to the wrong form ID, a JavaScript error stops the form from rendering, or the theme does not load footer scripts.
Start with the basics:
- Open Ninja Forms in the dashboard and note the form's ID.
- Check the shortcode or block on the page uses that same ID.
- Make sure the form is published, not a draft.
If the ID is correct, open your browser's developer tools and check the Console tab for red errors. The Chrome DevTools Console guide explains how to read them.
Ninja Forms needs your theme to call the standard WordPress footer hook. Most modern themes do this, but some custom or very old themes do not. Switch to a default theme briefly to test.
Page builders can also cause trouble. If the form shows in the block editor but not in a builder widget, try a plain shortcode widget instead.
Why is Ninja Forms stuck on processing?
When the submit button spins forever, the form's background request to WordPress has failed or returned an error, often because of a JavaScript conflict, security rule or PHP error.
Ninja Forms submits through AJAX in WordPress. The browser sends the data to admin-ajax and waits for a reply. If the reply never arrives or is not valid, the button keeps spinning.
Open developer tools before submitting, then check the Network tab for the admin-ajax request. Look at its status code and response. A 403 points to a firewall, a 500 points to a PHP error.
Ninja Forms has a guide on fixing forms stuck on processing that walks through these checks.
If you see a PHP error, turn on WordPress debugging to see the full message. Our guide on how to enable debug mode shows how.
Is a caching or optimisation plugin breaking the form?
Caching and script optimisation plugins often break Ninja Forms by combining, deferring or delaying its JavaScript, or by serving an old copy of the page with an expired security token.
Turn off these features one at a time and test the form:
- JavaScript combining or minifying.
- Delaying JavaScript until user interaction.
- Deferring scripts.
- CSS combining, if the layout breaks.
If the form works with an option off, add Ninja Forms' scripts to that feature's exclusion list instead of turning it off for the whole site.
Also clear every cache after changes. Our guide on how to clear cache in WordPress lists each layer.
Is a plugin or theme conflict to blame?
Another plugin or your theme can load conflicting scripts or change how WordPress handles requests, so a conflict test is the most reliable way to find the cause.
Steps:
- Back up the site or use a staging copy.
- Deactivate all plugins except Ninja Forms and its add-ons.
- Test the form and the builder.
- Reactivate plugins one at a time, testing after each.
- Switch to a default theme if plugins are not the cause.
The Health Check and Troubleshooting plugin lets you do this for your own session only, so visitors are not affected.
Our guide on how to fix a plugin conflict covers the method in more detail.
Are security rules blocking submissions?
Security plugins and server firewalls can block form submissions that contain certain words, code-like text or many fields, returning a 403 error that leaves the form stuck.
Look at the admin-ajax request in the Network tab. A 403 or a firewall block page in the response is a strong clue.
Check your security plugin's firewall log for blocked requests at the time you submitted. Allow the specific rule rather than switching off protection.
Server firewalls such as ModSecurity are controlled by your host. Send them the time of the failed submission and ask them to check the logs.
Cloudflare and other CDNs can also block requests. Our guide to Cloudflare WAF rules for WordPress explains how to review blocks.
Why will the form builder not load?
A blank or spinning builder usually comes from an outdated add-on, a plugin conflict in the dashboard, a PHP memory limit, or a browser extension blocking scripts.
Update Ninja Forms and every Ninja Forms add-on together. Mismatched versions are a common cause after updates.
Then check PHP memory. Big forms with many fields need more memory to load. Our guide on increasing the PHP memory limit explains how.
Try another browser or a private window with extensions off. Ad blockers and privacy extensions sometimes block builder scripts.
Why are submissions not being saved?
Submissions are saved by a specific form action, so if that action was removed or turned off, entries will not appear under Submissions even though the form seems to work.
Open the form in the builder and go to the Emails and Actions area. Make sure a Store Submission action exists and is turned on.
If the action is there but entries still do not appear, check your database. Errors writing to the database often appear in the PHP error log.
Our guide on how to read the WordPress debug log helps you find those messages.
Why are emails from Ninja Forms not arriving?
Missing emails usually mean the server cannot send mail reliably, so set up SMTP with an authenticated mail service and check the email action settings in the form.
Ninja Forms uses the standard WordPress mail function. Many hosts do not deliver that mail well, and inboxes often reject it as spam.
Check that the email action is on and that the To address is correct. Then send a test message with an SMTP plugin.
Our guide on how to set up SMTP in WordPress walks through the setup.
How do you get help from Ninja Forms support?
Collect your system status, the exact error message, and the steps that cause the problem, then contact Ninja Forms support or post on the WordPress.org forum.
Ninja Forms includes a help screen in the dashboard that shows system information. Copy it into your support request.
The Ninja Forms troubleshooting article covers more edge cases. Free users can also post on the Ninja Forms support forum.
Include your WordPress, PHP and Ninja Forms versions, and which add-ons you use.
How do you prevent Ninja Forms problems?
Keep Ninja Forms and its add-ons updated together, exclude form scripts from optimisation, test forms after every update, and use SMTP for email.
A short routine helps:
- Update on a staging site first when possible.
- Submit a test entry after each update.
- Check that the entry saves and the email arrives.
- Review firewall logs if a form suddenly fails.
Our overview of what Ninja Forms is covers its features if you are deciding whether it still suits your site.
Frequently asked questions
Why does my Ninja Forms form not show on the page?
Check that the shortcode or block uses the right form ID and that the form is published. Then look for JavaScript errors in the browser console, and test with a default theme in case your theme does not load footer scripts.
How do I fix Ninja Forms stuck on processing?
Open the browser's Network tab and submit the form. Check the admin-ajax request status. A 403 points to a firewall, a 500 to a PHP error, and console errors point to a script conflict. Fix the cause the status shows.
Why are Ninja Forms submissions not showing?
Submissions are saved by the Store Submission action. Open the form, check the Emails and Actions area, and make sure that action exists and is turned on. If it is, check the PHP error log for database errors.
Can a caching plugin break Ninja Forms?
Yes. Combining, deferring or delaying JavaScript can stop the form from loading or submitting, and stale cached pages can carry expired security tokens. Exclude Ninja Forms scripts from optimisation and clear every cache layer.
Why does the Ninja Forms builder not load?
Outdated add-ons, plugin conflicts, low PHP memory and browser extensions are the usual causes. Update Ninja Forms and all add-ons together, raise the memory limit and test in a private window without extensions.
Sources
- Troubleshooting Ninja Forms Ninja Forms
- How to fix Ninja Forms stuck on processing Ninja Forms
- Ninja Forms plugin WordPress.org
- Console overview Chrome for Developers
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.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


