Troubleshooting
Gravity Forms Not Showing on Page: Causes and How to Fix It

Short answer
Gravity Forms usually fails to show because the form is inactive, the shortcode or block uses the wrong form ID, or a caching or JavaScript optimization plugin is breaking its scripts. Form restrictions like entry limits, schedules and login requirements can also replace the form with a message.
Key takeaways
- Check the form is active and the shortcode ID matches the forms list.
- Use the Gravity Forms block instead of pasting shortcodes into code blocks.
- Entry limits, schedules and login rules can replace the form with a message.
- Combine, defer and delay JavaScript options often hide forms with conditional logic.
- Test logged out in a private window, since admins see more than visitors.
Why is Gravity Forms not showing on your page?
A Gravity Forms form usually fails to show because the form is inactive, the shortcode or block points to the wrong form ID, a cache or script optimization plugin is breaking its JavaScript, or a form setting is hiding it.
The good news is that most causes take a few minutes to fix. Start with the quick checks below, then move to caching and conflicts if the form is still missing.
First, look at what the page actually shows. The clue tells you where to look:
| What you see | Likely cause |
|---|---|
| The raw shortcode text, like [gravityform id=...] | Shortcode in the wrong block or a builder that does not run shortcodes |
| Oops! We could not locate your form. | Wrong form ID or the form was deleted |
| A message such as the form is closed | Schedule, entry limit or login setting |
| A blank space where the form should be | JavaScript error, cache or CSS hiding the form |
| The form shows for you but not visitors | Page cache or a login requirement |
| Nothing at all, not even the title | Form inactive, theme or plugin conflict |
The official Gravity Forms common issues page lists more symptoms and matches them to known fixes.
Is the form active and is the form ID correct?
Check Forms > Forms to make sure the form is active, then confirm the ID in your shortcode or block matches the ID shown in the forms list.
Inactive forms do not display on the front end. In the forms list, each form has a toggle showing whether it is active. Turn it on if it is off.
Next, check the ID. Each form has a number in the ID column of the forms list. Your shortcode must use the same number:
[gravityform id="3" title="false" description="false" ajax="true"]
If the form was deleted and recreated, it gets a new ID, so old shortcodes stop working. The Gravity Forms shortcode reference lists every supported attribute.
A form in the trash also counts as missing. Restore it from the Trash view on the forms list if you deleted it by accident.
Is the shortcode or block added the right way?
Use the Gravity Forms block or a Shortcode block in the block editor, and make sure the shortcode is not inside a Code, Preformatted or HTML block that prints it as plain text.
Shortcodes copied from emails or documents often carry smart quotes, the curly quote marks, which WordPress does not read as shortcode quotes. Retype the quotes by hand in the editor.
The simplest fix is to use the official block:
- Edit the page in the block editor.
- Click the + inserter and search for Gravity Forms.
- Add the block and choose your form from the dropdown.
- Update the page.
The Gravity Forms block guide shows the block settings, including title, description and AJAX options.
Page builders need extra care. Use the builder's own Gravity Forms widget, or a shortcode widget, rather than a plain text or heading element. Some builders only render forms on the live page, not inside the editor preview, so always check the published page.
Is a form setting hiding the form?
Yes, it can be, because Gravity Forms can close a form by schedule, by entry limit, or by requiring visitors to log in, and each one shows a message instead of the form.
Open the form, go to Settings > Form Settings, and look at the restrictions area:
- Limit number of entries. Once the limit is reached, the form shows your limit message.
- Schedule form. Outside the start and end dates, the form shows the scheduled message.
- Require user to be logged in. Logged-out visitors see the login message instead of the form.
Admins are logged in, which is why a login-only form shows for you but not for visitors. Always test a form in a private browser window.
Conditional logic can also hide every field if the rules are set the wrong way. Check any rules on the first fields and the submit button.
Is caching or script optimization breaking the form?
Very often, yes, because page caches can serve an old version of the page, and minify or defer settings can break the JavaScript that Gravity Forms needs to display some forms.
Forms that use conditional logic are hidden at first and revealed by JavaScript. If a script fails to load, or runs in the wrong order, the form stays hidden.
Try this:
- Clear your cache plugin, server cache and CDN cache.
- Turn off Combine JavaScript, Defer JavaScript and Delay JavaScript options in your optimization plugin.
- Reload the page in a private window.
- If the form appears, turn options back on one at a time and exclude Gravity Forms scripts or jQuery from the setting that breaks it.
Our guide to clearing cache in WordPress covers each layer, including the CDN.
If you use LiteSpeed Cache, our guide on fixing LiteSpeed Cache breaking a site shows where those JavaScript options live.
Form pages that use AJAX submission should also be excluded from aggressive caching if submissions fail or nonce errors appear.
Are JavaScript errors stopping the form from loading?
Open your browser's developer tools, check the Console tab for red errors, and fix or remove the script that throws the first error.
A single error from another plugin or the theme can stop every script after it, including Gravity Forms.
To check:
- Open the page with the missing form.
- Right-click and choose Inspect, then open the Console tab.
- Reload the page and look for red error messages.
- Note the file name in each error, which often names the plugin or theme.
The Chrome DevTools Console guide explains how to read these messages.
Common culprits include old jQuery code in a theme, a plugin that loads its own copy of jQuery, and scripts that expect elements missing from the page.
Is a plugin or theme conflict hiding the form?
It may be, so switch to a default theme and turn off other plugins on a staging site, then turn them back on one at a time until the form disappears again.
The free Health Check and Troubleshooting plugin lets you do this only for your own session, so visitors see no change on a live site.
Watch for these signs of a conflict:
- The form shows with a default theme but not with yours.
- The form returns when one plugin is turned off.
- The form shows on some pages but not on pages built with a certain builder.
Themes must call standard WordPress functions, such as wp_footer, for plugin scripts to load. Custom or very old themes sometimes leave these out, which stops form scripts from loading.
Our full walkthrough on fixing a plugin conflict covers the testing method step by step.
Is CSS hiding the form?
Sometimes, yes, because theme or custom CSS can set the form container to display none, zero height, or the same color as the background.
Inspect the empty space where the form should be. In developer tools, look for the gform_wrapper element. If it exists in the page code but you cannot see it, CSS is the problem.
Things to check:
- Custom CSS in the Customizer or Site Editor that targets forms or inputs.
- Popups or tabs that hide content until clicked.
- White text on a white background, which makes fields look missing.
- Gravity Forms' own CSS turned off under Forms > Settings, leaving the form unstyled or collapsed.
If the form is in a popup or tab, it may need its scripts started after the popup opens. Check the popup plugin's documentation for Gravity Forms support.
How do you turn on debugging to find the cause?
Enable WordPress debug logging, reload the page, and read the debug log for PHP errors from Gravity Forms, the theme, or other plugins.
Add these lines to wp-config.php, above the line that says to stop editing:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Errors are then written to wp-content/debug.log. The WordPress debugging documentation explains each constant. Our guide on enabling debug mode in WordPress has more detail.
Gravity Forms also has its own logging under Forms > Settings. Turn it on, reproduce the problem, and view the logs from the settings page. Turn logging off again when you are done.
What should you do if the form still does not show?
Update Gravity Forms, WordPress and your theme, check your license is active for updates, and contact Gravity Forms support with your system report.
An outdated copy of Gravity Forms may not work with a newer WordPress version or a new block editor feature. Updating often fixes display problems.
Before you contact support, collect:
- The page URL with the missing form.
- The form ID.
- Any console errors and debug log entries.
- The system status report from Forms > System Status.
If you need to reinstall the plugin, our guide on installing Gravity Forms on WordPress covers a clean install. Your forms and entries stay in the database during a reinstall.
Once the form shows, send a test entry. If entries arrive but emails do not, our guide on Gravity Forms notifications not sending is the next step.
Frequently asked questions
Why does my Gravity Forms shortcode show as text?
The shortcode is probably inside a Code, Preformatted or HTML block, or in a page builder element that does not run shortcodes. Curly quotes copied from a document can also break it. Use the Gravity Forms block or a Shortcode block and retype the quotes.
Why does the form show for me but not for visitors?
You are logged in, so you may bypass the page cache and any login requirement on the form. Visitors get the cached page or the login message. Clear the cache and check the form's restriction settings, then test in a private window.
What does the message about not locating your form mean?
It means the form ID in your shortcode or block does not match any active form. The form may be deleted, in the trash, or recreated with a new ID. Update the shortcode or reselect the form in the block.
Can a caching plugin stop Gravity Forms from showing?
Yes. Options that combine, defer or delay JavaScript can stop the scripts that reveal forms with conditional logic. Turn those options off, test, and then exclude Gravity Forms and jQuery from the setting that causes the problem.
Do I lose entries if I reinstall Gravity Forms?
No. Forms and entries live in the WordPress database, not in the plugin folder. Replacing the plugin files keeps your data. Only the plugin's own uninstall tool, which you must run on purpose, removes that data.
Sources
- Common Form Issues Gravity Forms Docs
- Shortcodes Gravity Forms Docs
- Adding a Form Using the Gravity Forms Block Gravity Forms Docs
- Debugging in WordPress WordPress Developer Resources
- Health Check & Troubleshooting 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.


