Troubleshooting
Gravity Forms Signature Not Working: Causes and How to Fix It

Short answer
A Gravity Forms signature usually fails because the Signature Add-On is inactive or outdated, a caching or optimization plugin delays its JavaScript, or the uploads folder blocks saved images. Update core and the add-on, exclude form scripts from optimization, then test on desktop and mobile.
Key takeaways
- The signature field needs the official Signature Add-On and a license that includes it.
- Update Gravity Forms core and the add-on together to avoid version mismatches.
- Deferred or delayed JavaScript is the top reason the pad will not draw.
- Hidden canvases on later form pages often break signing on phones.
- Missing images in entries point to upload folder permissions or security rules.
Why is the Gravity Forms signature field not working?
The signature field usually fails because the Signature Add-On is inactive or unlicensed, a script optimization breaks its JavaScript, or the server blocks access to saved signature images.
The Signature Add-On draws a small canvas on the form. Visitors sign with a mouse, finger or stylus, and Gravity Forms saves the drawing as an image file when the form is submitted.
That process depends on three things working together. The add-on must load, the browser must run its JavaScript, and WordPress must save and serve the image file.
Most problems fall into one of these groups:
| Symptom | Most likely cause | First fix to try |
|---|---|---|
| No Signature field in the editor | Add-on not installed, active or licensed | Install and activate the add-on |
| Field shows but you cannot draw | JavaScript conflict or deferred scripts | Exclude Gravity Forms scripts from optimization |
| Cannot sign on phones | Touch handling or a tiny, hidden canvas | Update the add-on and test without the theme scripts |
| Signature clears after an error | Validation reload on a multi-page or AJAX form | Update and test the form with AJAX on and off |
| Image missing in entries or emails | Upload folder blocked or wrong permissions | Check the signatures folder and security rules |
| Signature fails as required | Field hidden by conditional logic or never drawn | Review logic and required settings |
Work through the sections below in order. Start with the cheapest checks, then move to plugins, caching and the server.
Is the Signature Add-On installed, active and licensed?
Check under Forms > Add-Ons that the Signature Add-On is installed and active, and that your license level includes it.
The signature field is not part of the core Gravity Forms plugin. It is an official add-on, and it is only offered on certain license tiers. If your license does not include it, the field never appears in the form editor.
Go to Forms > Settings and confirm the license key is valid. Then open Forms > Add-Ons and look for Signature. If it is listed as available but not installed, install and activate it.
If you are unsure what your plan covers, our breakdown of Gravity Forms pricing lists the license tiers. The Gravity Forms licensing FAQ also explains how keys and renewals work.
An expired license does not normally switch off the add-on, but it stops updates. An old Signature Add-On running beside a newer Gravity Forms core is a common source of odd behavior.
Are Gravity Forms and the add-on up to date?
Update Gravity Forms core and the Signature Add-On together, because an old add-on paired with a newer core often breaks drawing or saving.
Go to Forms > System Status and check the versions listed for Gravity Forms and each add-on. Update anything that is behind from the Plugins screen or the Updates screen.
If automatic updates fail, Gravity Forms explains how to manually update by uploading a fresh zip from your account. Our guide on how to update Gravity Forms walks through the safe order.
Also update WordPress, your theme and any plugin that changes forms, such as a form styling plugin. Then clear every cache and test again in a private browser window.
Is a JavaScript conflict stopping the signature pad?
If the box shows but nothing draws, a JavaScript error, deferred script loading or a plugin conflict is the most likely cause.
Open the form page, right-click and choose Inspect, then open the Console tab. Try to sign and watch for red errors. An error mentioning jQuery, a signature script or is not defined points to a loading problem.
Performance plugins are the usual suspects. Settings that delay, defer or combine JavaScript can load the signature script before jQuery, or wait until the visitor scrolls. The pad then never initializes.
Try these steps:
- Turn off JavaScript delay, defer and combine in your caching plugin, then clear the cache
- If that fixes it, turn the features back on and exclude Gravity Forms scripts and jQuery
- Turn off Cloudflare Rocket Loader or similar script loaders for the form page
- Retest in a private window after clearing every cache layer
If you use WP Rocket, our list of delay JavaScript exclusions shows how exclusions work. The same idea applies to other optimization plugins.
When caching is not the cause, test for a conflict. Deactivate other plugins one at a time, or use a staging copy. Our guide on fixing a plugin conflict explains a clean method, and the free Health Check and Troubleshooting plugin lets you test with plugins disabled only for your own session.
Why does the signature not work on mobile?
Signatures fail on phones when the canvas is too small, hidden when the page loads, or blocked by theme scripts that capture touch and scroll events.
The pad is an HTML canvas element, described in the MDN Canvas API docs. A canvas has a fixed drawing size set when it loads. If it starts inside a hidden section, it can end up sized at zero.
This often happens when the field sits on a later page of a multi-page form, inside a hidden tab, or behind conditional logic. When the field appears, the canvas may not resize correctly.
Fixes to try:
- Update the add-on, since mobile handling has improved over time
- Set a sensible width in the field settings so it fits narrow screens
- Move the field onto the first visible page as a test
- Turn off theme features such as smooth scrolling, swipe menus or touch sliders on the form page
- Test in another mobile browser to rule out a browser quirk
Members of the Gravity Forms community report similar mobile problems in this support thread. The fixes there match the list above.
Why does the signature disappear after a validation error?
The signature can clear when the form reloads after a failed validation, because the drawing lives in the browser until a successful submission saves it.
Gravity Forms keeps most field values after an error, but the signature is image data rather than plain text. On some setups, especially with caching or optimization plugins in the way, that data is lost on reload.
Steps that help:
- Update core and the add-on, since newer versions retain the signature better
- Test the form with AJAX submission on and off in the block or shortcode settings
- Exclude the form page from page caching
- Place the signature near the end of the form so visitors sign after other fields pass
If the problem only happens on one page, compare that page's caching and script rules with a page where the form works.
Why are signature images missing from entries or emails?
Missing signature images usually mean the image was not saved, or the server or a security rule blocks the folder where signatures are stored.
Gravity Forms saves signature images inside the uploads folder in a Gravity Forms signatures directory. If WordPress cannot write there, no image is created. If a rule blocks reading, the entry shows a broken image.
Check these points:
- Folder permissions. The uploads folder must be writable by the web server. Our guide on correct file permissions lists safe values.
- Security plugins. Firewall or hardening rules that block direct access to files in uploads can stop the image loading.
- Server rules. Custom .htaccess or Nginx rules that deny image access in that folder cause the same symptom.
- Disk space. A full hosting account cannot save new files.
If the image shows in the entry but not in notifications, check that email clients are not blocking remote images. Some mail apps hide images until the reader allows them. Our guide on Gravity Forms notifications not sending covers wider email problems.
PDF add-ons sometimes need extra settings to embed signatures. If a PDF shows a blank space, check that plugin's documentation and update it too.
How do you debug the problem further?
Turn on WordPress debug logging, check the Gravity Forms logging tool, and compare the System Status report with a working setup.
WordPress can write PHP errors to a log file. The debugging guide in the developer handbook shows the wp-config.php constants to set, and our guide on enabling debug mode covers the same steps.
Gravity Forms has its own logging. Enable it under Forms > Settings, then turn on logging for Gravity Forms and the Signature Add-On. Submit a test form and read the logs for errors around file saving.
When you contact Gravity Forms support, include your System Status report, the browser and device used, any console errors, and the steps to reproduce the issue. That speeds up a reply.
How do you stop signature problems coming back?
Keep Gravity Forms and its add-ons updated together, exclude form scripts from aggressive optimization, and test a signed submission after every major change.
A short routine helps:
- Test the form on a phone and a desktop after updates
- Keep a staging site for plugin and theme updates
- Re-check script exclusions when you change caching plugins
- Watch the uploads folder size and hosting disk quota
If you are still choosing a form plugin, our review of whether Gravity Forms is worth it weighs its add-ons against free options.
For a general walkthrough, see how to use Gravity Forms.
Frequently asked questions
Why is there no signature field in my Gravity Forms editor?
The Signature Add-On is not installed or active, or your license does not include it. Check Forms > Add-Ons and your license level, then install and activate the add-on.
Can I use the Gravity Forms signature field with AJAX forms?
Yes. The field supports AJAX submission. If signatures clear or fail with AJAX on, update core and the add-on, exclude the page from caching and test with AJAX off to isolate the cause.
Where does Gravity Forms store signature images?
Signature images are saved as files inside the WordPress uploads folder in a Gravity Forms signatures directory. The entry stores a reference to the file, so the folder must stay writable and readable.
Is a Gravity Forms signature legally binding?
This is general information, not legal advice. A drawn signature can support an agreement in many places, but rules differ by country and document type. Ask a lawyer if the form covers contracts or regulated documents.
Why does the signature box look tiny or cut off?
The canvas may have loaded while hidden, or the width setting is too wide for small screens. Set a narrower width in the field settings and avoid starting the field inside a hidden section.
Sources
- How to Manually Update Gravity Forms Gravity Forms Documentation
- Common Questions about Gravity Forms Licensing Gravity Forms Documentation
- Gravity Forms Signature Add-On does not work on mobile Gravity Forms Community
- Canvas API MDN Web Docs
- Debugging in WordPress 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.


