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

Short answer
Ninja Forms usually fails to load because JavaScript is blocked or broken, often by a cache plugin delaying or combining scripts, a plugin conflict, or a theme missing the wp_footer hook. Check the browser console, exclude Ninja Forms and jQuery from script optimization, purge caches and test with other plugins disabled.
Key takeaways
- Ninja Forms builds forms with JavaScript, so any script error can stop the form appearing.
- Check the browser console first for errors that name the plugin or theme at fault.
- Exclude Ninja Forms and jQuery from delay, defer and combine settings in cache plugins.
- Themes must call wp_footer for Ninja Forms templates and scripts to load.
- Keep Ninja Forms, its add-ons and PHP up to date together.
Why is Ninja Forms not loading?
Ninja Forms usually fails to load because a JavaScript error, a script optimization setting or a missing theme hook stops the browser from building the form.
Ninja Forms builds its forms with JavaScript in the visitor's browser. If anything blocks those scripts, the page may show an empty space, a short notice that JavaScript is required, or only the form title.
The same applies inside the dashboard. The form builder is also a JavaScript app, so a broken script can leave you with a blank builder screen or a list of forms that never appears.
Work through the checks below in order and test the form after each one.
| What you see | Likely cause | First thing to try |
|---|---|---|
| Blank space where the form should be | JavaScript error or delayed scripts | Check the console, exclude scripts from optimization |
| Notice that JavaScript is required | Scripts blocked or not loaded | Check optimization and theme footer |
| Form loads for you but not for visitors | Cached page or minified files | Purge cache and test logged out |
| Builder in the dashboard is blank | Plugin conflict or PHP error | Conflict test and debug log |
| Form broke after an update | Version mismatch with add-ons or PHP | Update everything, check PHP version |
Is the form embedded correctly?
Make sure the page uses the Ninja Forms block or the correct shortcode with the right form ID, and that the form is not deleted or in the trash.
Open Ninja Forms > Dashboard and note the ID of the form. The shortcode looks like this:
[ninja_form id=3]
A wrong ID shows nothing at all, which looks just like a loading failure. Page builders such as Elementor also need the shortcode inside a Shortcode widget, not a Text widget, or the shortcode may print as plain text.
If you are new to the plugin, our overview of what Ninja Forms is explains how forms and embeds fit together.
How do you check for JavaScript errors?
Open the page with the form, press F12, go to the Console tab and reload; red errors there are the most direct clue to why the form will not render.
The Chrome DevTools Console guide shows how to read these messages. Look at the file name in each error, since it usually names the plugin or theme responsible.
Errors such as jQuery is not defined or Backbone is not defined mean a required library loaded too late or not at all. That is almost always caused by script optimization, covered next.
Also check the Network tab. Files that fail with a 404 or 403 status are not reaching the browser, which can come from security rules or a broken CDN path.
Could caching or script optimization block the form?
Yes, delaying, deferring or combining JavaScript is the most common reason Ninja Forms stops loading, because the form needs its scripts and jQuery in the right order.
Cache and speed plugins such as WP Rocket, LiteSpeed Cache, Autoptimize and W3 Total Cache all have settings that change how scripts load.
- Turn off Delay JavaScript execution, or exclude ninja-forms and jQuery from it
- Turn off JavaScript combine or aggregate options
- Exclude jQuery, Underscore and Backbone from defer
- Purge all caches, including host and CDN caches
- Test the form in a private window while logged out
If disabling these fixes the form, turn them back on one by one and add exclusions instead of leaving everything off. Our guide on fixing WP Rocket breaking a site shows how to narrow down the setting.
Cloudflare's Rocket Loader can cause the same problem. Its Rocket Loader documentation explains how to switch it off.
Is the theme missing the footer hook?
Ninja Forms needs the theme to call wp_footer(), because it prints its form templates and scripts there; without it, the form cannot render.
Most well-built themes include this call. Custom themes, landing page templates and some page builder canvas templates occasionally leave it out.
Test by switching to a default theme such as Twenty Twenty-Five on a staging copy. If the form appears, the theme is the problem.
The developer reference for wp_footer() explains that it belongs just before the closing body tag in the theme's footer file. Ask the theme developer to add it if it is missing.
Is a plugin conflict stopping Ninja Forms?
A conflict is likely if the console shows errors from another plugin's files, or if the form loads once other plugins are switched off.
Common causes include other form plugins, popup and slider plugins, and plugins that load their own old copy of jQuery or Backbone. Two versions of the same library can break each other.
The Health Check & Troubleshooting plugin lets you disable plugins for your own session only. That way visitors keep seeing the normal site while you test.
Re-enable plugins one at a time and reload the form after each one. Our guide on fixing a plugin conflict covers the method in more detail.
Why does the Ninja Forms dashboard or builder not load?
A blank Ninja Forms dashboard or builder usually means a JavaScript error in the admin area, a PHP error, or a memory limit being reached.
Check the browser console while on the Ninja Forms admin screen. Admin-only plugins, such as those that add custom fields or menus, can break the builder.
Turn on logging with our guide to enabling debug mode in WordPress, then reload the builder. Fatal errors in the debug log will name the file at fault.
Ninja Forms also has a Get Help screen with a system status report. It lists your PHP version, memory limit and active plugins, which is useful for spotting problems and for support requests.
Could PHP or plugin versions be the problem?
Yes, an outdated PHP version, an old copy of Ninja Forms or mismatched add-on versions can stop forms loading after an update.
Check the requirements on the Ninja Forms plugin page and compare them with your site. Update Ninja Forms and every Ninja Forms add-on together, since add-ons are built for matching core versions.
If your host runs an old PHP version, our guide on updating the PHP version in WordPress shows how to change it safely.
Take a backup before updating anything. If a fresh update caused the issue, rolling back the plugin to the previous version is a reasonable short-term fix while you contact support.
Do security tools block the form files?
Security plugins, server firewalls and CDNs can block Ninja Forms scripts or its AJAX requests, which leaves the form blank or unable to submit.
Look in the Network tab for files or requests with a 403 status. Then check your security plugin's log or your host's firewall log for blocks at the same time.
Allowlist the specific rule rather than turning the firewall off. Sites behind Cloudflare should also check any custom WAF rules that touch admin-ajax.php.
What if the form loads but does not send?
If the form loads and submits but no email arrives, the issue is email delivery, not loading, and needs an SMTP setup instead.
Check Ninja Forms > Submissions to confirm entries are being saved. If they are, the form itself works.
Our guide on Ninja Forms not sending email covers SMTP, sender addresses and spam filters.
For a similar problem in another plugin, see Gravity Forms AJAX not working.
When should you contact Ninja Forms support?
Contact support when the form still will not load on a default theme with other plugins disabled and no script optimization, since that points to a bug or server issue.
Include the system status report, the console errors, your PHP version and the exact steps to reproduce the problem. The Ninja Forms team's own troubleshooting article lists the checks they will usually ask you to run first.
Free users can post on the WordPress.org support forum for the plugin. Paid add-on customers can use the support channel included with their license.
Frequently asked questions
Why is my Ninja Form blank on the page?
A blank form usually means the JavaScript that builds it did not run. Check the browser console for errors, turn off script delay and combine options in your cache plugin, purge caches and test again while logged out.
Does Ninja Forms work with WP Rocket?
Yes, but WP Rocket's Delay JavaScript execution and combine options can stop forms rendering. Add Ninja Forms and jQuery to the exclusions or turn those options off, then clear the cache.
Why does my Ninja Form show only for logged-in users?
Logged-in users usually skip page cache and some script optimization. If visitors see a blank form, the cached page or optimized scripts are the likely cause. Purge caches and add exclusions for the form page.
Why is the Ninja Forms builder blank in the dashboard?
A blank builder is usually caused by a JavaScript error from another admin plugin, a PHP error or a low memory limit. Check the console and debug log, and run a conflict test with other plugins disabled.
How do I find my Ninja Forms form ID?
Go to Ninja Forms then Dashboard. Each form in the list shows its ID and shortcode. Use that ID in the shortcode, or select the form by name in the Ninja Forms block.
Sources
- Ninja Forms WordPress.org Plugins
- Troubleshooting Ninja Forms: Fixes for Common Problems Ninja Forms
- Console overview Chrome for Developers
- wp_footer() WordPress Developer Resources
- Health Check & Troubleshooting WordPress.org Plugins
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.


