🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!

Gravity Forms Upload Tools Pack Premium Add-on Setup Guide

Updated 12 min read Gravity Forms Files, Storage & Databases
On this page
  1. Video walkthrough
  2. Step 1: Install and Activate Your License
  3. Step 2: Choose the Tools for Your Site
  4. Step 3: Turn Tools On for a File Upload Field
  5. File Renaming
  6. Upload Rules
  7. Resize Large Images
  8. Media Library Copies
  9. Merge Tags
  10. Upload Experience: Previews, Reorder and Drag-and-Drop (new in 1.1.0)
  11. Turn it on for a field
  12. The four helpers
  13. Turn it off
  14. Updating from 1.0.0
  15. Changelog: 1.1.0
  16. Resize and Compress Images in the Browser (new in 1.2.0)
  17. Turn it on for a field
  18. What happens to each file
  19. Remove photo details for privacy
  20. Server resize as a safety net
  21. Updating from 1.1.0
  22. Changelog: 1.2.0
  23. Limits and What Is Not Included
  24. Troubleshooting & FAQ
  25. The image was refused but it is still listed under the field.
  26. Images are not resized and have no thumbnails.
  27. A merge tag in the file name is empty.
  28. Can a visitor upload a file type the field does not allow?
  29. Is anything left behind if I uninstall?
  30. Resource Hub

Video walkthrough

Rename Gravity Forms File Uploads + Image Size Rules & Media Library
Video walkthrough: rename uploads, image size rules and Media Library copies for Gravity Forms. Watch on YouTube

The Gravity Forms File Upload field stores files with the name they had on the visitor’s computer, in a dated folder, outside the WordPress Media Library, and it accepts images of any size. The Gravity Forms Upload Tools Pack Premium Add-on adds four tools you switch on per File Upload field: file renaming, upload rules, image resizing and Media Library copies.

This guide covers installation, each tool, the merge tags, the upload experience helpers added in 1.1.0, the limits and troubleshooting.

System Requirements & Prerequisites

  • WordPress: Version 6.5 or higher
  • PHP: Version 7.4 or higher, with the GD or Imagick image library (needed for resizing and Media Library thumbnails)
  • Gravity Forms: Version 2.9 or higher
  • A form with a File Upload field
  • GravityExtra license: The add-on installed, activated and licensed with an active GravityExtra license key

Step 1: Install and Activate Your License

  1. In WordPress go to Plugins → Add New → Upload Plugin, upload the add-on ZIP file and click Activate.
  2. Go to Forms → Settings → Upload Tools, enter your key in the Gravity Extra License section and click Activate License.
  3. Reload the page. The Features and Media Library sections appear. The tools work only while the license is active.

Step 2: Choose the Tools for Your Site

Under Features, five toggles control the tools for the whole site: File renaming, Upload rules, Resize large images, Media Library copies and File upload UX (new in 1.1.0, see Upload Experience). They are on by default, but nothing changes on your forms until you turn a tool on for a field. Turn a toggle off to switch that tool off on every form at once.

Under Media Library, Delete Media Library copies when an entry is deleted is off by default. When it is on, permanently deleting an entry also deletes the Media Library files the add-on created for it, even if they are used in a post.

Step 3: Turn Tools On for a File Upload Field

Open the form in the form editor and click a File Upload field. On the General tab, below Maximum File Size, the Upload Tools block lists the tools that are on for the site. Tick a tool to show its options, then click Save Form.

Upload Tools block in the File Upload field settings with renaming, upload rules, resize and Media Library options
The Upload Tools block on a multi-file upload field.

File Renaming

Tick Rename uploaded files and enter a File name template. The default is {entry_id}-{filename}. You can use:

  • {filename}: the original name without its extension
  • {file_number}: the position of the file in the field (1, 2, 3…)
  • {field_id}, {entry_id}, {form_id}, {date_mdy} and any field merge tag, for example {Company:3}

Files are renamed right after the entry is saved, so notifications, file attachments and secure download links already use the new names. Names are cleaned: spaces become dashes, accents, slashes, dots and other special characters are removed, and very long names are shortened. The extension of the uploaded file is always kept. When two files end up with the same name, the second becomes name-2.jpg, the third name-3.jpg, and so on; nothing is overwritten.

The optional Sub-folder template (optional), for example clients/{Company:3}, puts the files in a sub-folder inside this form’s upload folder. Separate levels with a slash (up to five). The template is split into levels before merge tags are replaced, so a visitor’s answer can never add folder levels or point outside the form’s folder.

Upload Rules

Tick Apply upload rules and fill in the limits you need. Leave a box empty for no limit.

  • Minimum number of files: multi-file fields only. The maximum is the field’s own Maximum Number of Files setting. An optional field left empty is still accepted.
  • Min. image width (px), Min. image height (px), Max. image width (px), Max. image height (px) and Max. megapixels: checked for JPEG, PNG, GIF, WebP and other images the server can read. Other files, such as PDFs, are not affected.

The rules are checked on the server when the form is submitted, so they cannot be skipped in the browser. On multi-file fields each image is also checked as soon as it is uploaded, and a file that breaks a rule is refused with the reason next to its name. The rules are added to the field’s description line, for example “Min. files: 2. Images: at least 1200 × 800 px, max. 24 megapixels.”

Gallery upload field showing the rules under the drop area and a refused image with the message that it must be at least 800 pixels wide
A too-small image is refused as soon as it is uploaded.

Resize Large Images

Tick Resize large images and enter Max. width (px), Max. height (px) or both, and optionally a Quality (1-100) (82 by default). After the form is submitted, JPEG, PNG and WebP images larger than this box are scaled down proportionally and saved in the same format. Smaller images and GIF images are kept as they are. If you also set a maximum width or height under upload rules, those images are refused instead of resized, so use one or the other.

Media Library Copies

Tick Add files to the Media Library to copy each uploaded file into the WordPress Media Library after the entry is saved (after renaming and resizing). The submitting user is the author of the copy; for visitors who are not logged in, no author is set. The original file stays with the entry. Entries marked as spam are not copied.

  • Attach to the post created from this entry: when the form creates a post with Post fields, the copies are attached to that post.
  • Set the first image as the featured image: the first image becomes the post’s featured image, unless the post already has one (for example from a Post Image field).

The entry detail page shows a Media Library box with each copy and a link to edit it.

Media Library box on the entry detail page listing three images with links
The Media Library box on an entry.

Merge Tags

Add a modifier to the field’s merge tag in notifications and confirmations:

  • {Gallery:4:media_id}: the attachment IDs separated by commas, for example to build a gallery shortcode.
  • {Gallery:4:media_url}: links to the full-size files.
  • {Gallery:4:media_url_medium}: links to an image size, such as thumbnail, medium, large or a size registered by your theme.

Upload Experience: Previews, Reorder and Drag-and-Drop (new in 1.1.0)

Version 1.1.0 adds a fifth tool, Enhanced upload experience, to the standard Gravity Forms File Upload field. It helps visitors before they press Submit: they see what they picked, put several files in order, drop files onto the field and learn at once when a file will not be accepted. It is a progressive enhancement: with JavaScript turned off the plain field works exactly as before.

Turn it on for a field

  1. Check that File upload UX is on under Forms → Settings → Upload Tools → Features (it is on by default).
  2. Open the form, click a File Upload field and, in the Upload Tools block on the General tab, tick Enhanced upload experience.
  3. Tick the helpers you want, then click Save Form. Each helper is off until you tick it, and different fields can use different helpers.

Enhanced upload experience in the Upload Tools block of a File Upload field, with the thumbnail preview, drag and drop, drag to reorder and instant message options

The four helpers

  • Show a thumbnail preview of selected files: selected images appear as small thumbnails; on a single-file field, other files show a file-type icon with their name and size. The preview is drawn in the browser from the visitor’s own file; nothing is uploaded to build it, and it is cleared when the file is removed.
  • Let visitors drag and drop files onto the field: a single-file field gets a drop zone (“Drop files here or browse”) next to the usual Choose File button. Multi-file fields already have a Gravity Forms drop area and keep it.
  • Let visitors drag to reorder several files before submitting (multi-file fields only): uploaded files can be dragged into a new order, or moved with the ↑ and ↓ buttons, which have screen-reader labels. The entry stores the files in the order shown, so with Set the first image as the featured image the image at the top becomes the featured image.
  • Show an instant message when a file is the wrong type or too large: on a single-file field, a file whose extension is not in the field’s accepted file types, or that is larger than its maximum file size, gets a clear message at once and is left out. When the form is submitted, the add-on checks every file of the field on the server against the same two rules and refuses a file that breaks them, with the same wording. The browser check is a courtesy; the server check is the gate.

A multi-file Gravity Forms upload field with image thumbnails and up and down buttons to reorder the uploaded files

The accepted file types and the maximum file size come from the field’s own Gravity Forms settings, so there is nothing new to set up for the rules. The script and style of this tool load only on forms that have a File Upload field with a helper ticked; other forms get nothing extra.

Turn it off

Untick Enhanced upload experience on a field, or turn off File upload UX under Features to switch it off on every form. Renaming, upload rules, resizing and Media Library copies are not affected.

Updating from 1.0.0

Install 1.1.0 over 1.0.0 (same plugin folder) or update from the Plugins screen. Your settings, field options and entries are kept, and nothing on your forms changes until you tick a helper.

Changelog: 1.1.0

  • New: thumbnail previews, drag-to-reorder (multi-file), a drop zone on single-file fields and an instant type/size message, each switched on per field.
  • New: the accepted file types and maximum file size are re-checked on the server at submission, with the same message the browser shows.

Resize and Compress Images in the Browser (new in 1.2.0)

A phone photo is often 4,000 pixels wide and 3 to 6 MB. On a slow mobile connection that takes a long time to send, and it may be larger than the field’s maximum file size. Version 1.2.0 can make large photos smaller on the visitor’s own device before they are uploaded. The visitor picks or drops the photo as usual; the add-on resizes it in the browser and Gravity Forms uploads the smaller copy.

Turn it on for a field

  1. Check that Resize large images is on under Forms → Settings → Upload Tools → Features (it is on by default). The new option belongs to this tool.
  2. Open the form, click a File Upload field and, in the Upload Tools block on the General tab, tick Resize and compress images in the browser before upload.
  3. Enter a Max. width and/or Max. height in pixels (for example 1600 and 1600) and, if you like, a JPEG / WebP quality from 1 to 100 (82 when empty). Click Save Form.

The Resize and compress images in the browser option of a Gravity Forms File Upload field, with maximum width, maximum height, quality and remove photo details

What happens to each file

  • JPEG, PNG and WebP images larger than the box are scaled down to fit it, keeping their proportions, and saved in the same format. JPEG and WebP use the quality you set; PNG stays lossless and keeps its transparency. The file name stays the same.
  • Photos stay the right way up. Phones often store a photo sideways with a note (the EXIF orientation) that says how to turn it. The add-on applies that note while resizing, so the stored image is upright everywhere, also in programs that ignore the note.
  • Images inside the box are not re-encoded, so their quality does not change.
  • Sent unchanged: PDFs and other non-image files, GIF images, animated PNG and WebP images, HEIC photos, and any image the visitor’s browser cannot read. If anything goes wrong while an image is prepared, or it takes longer than 30 seconds, the original file is uploaded instead. Nothing is ever lost.
  • While images are being prepared, a short “Preparing images for upload” note appears under the field and the Submit button waits, usually for well under a second per photo.

The option works on single-file and multi-file fields, with click-to-browse and drag-and-drop, and together with the 1.1 helpers (thumbnail preview, reorder, instant type and size message). The size check runs on the smaller copy, so a 5 MB photo can pass a 2 MB limit once it has been resized.

Remove photo details for privacy

Photos carry hidden details: the camera, the date and often the exact GPS location where they were taken. Tick Remove photo details (camera, date and GPS location) for privacy to remove them. The add-on removes EXIF (including GPS), XMP, IPTC and comments from JPEG, PNG and WebP files without re-encoding the picture, so its quality does not change. Only the orientation note is kept, so the photo still shows upright.

The details are removed in the browser and again on the server after the form is submitted, so they are also removed when the visitor’s browser could not do it (for example with JavaScript turned off). You can use this option without a maximum size: leave the width and height empty.

Without this option, a resized photo keeps its EXIF details (with the orientation set to upright).

A Gravity Forms File Upload field showing the preview of a photo whose camera and GPS details were removed before upload

Server resize as a safety net

Resize large images (the server-side option from 1.0) works exactly as before and runs after submission. Turn on both: the browser makes the upload small and fast, and the server still shrinks any image that arrives large because the browser could not process it.

A multi-file Gravity Forms upload field with two photos resized in the browser, their smaller sizes and thumbnails

Updating from 1.1.0

Install 1.2.0 over 1.1.0 (same plugin folder) or update from the Plugins screen. Your settings, field options and entries are kept, and nothing on your forms changes until you tick the new option on a field.

Changelog: 1.2.0

  • New: resize and compress JPEG, PNG and WebP images in the browser before upload (maximum width and height, JPEG/WebP quality), per File Upload field; photos stay upright.
  • New: remove photo details (EXIF incl. GPS, XMP, IPTC, comments) in the browser and on the server, without re-encoding.
  • GIF, animated images, HEIC and other files are sent unchanged; any problem falls back to the original file.

Limits and What Is Not Included

  • Existing entries are not renamed or copied; the tools work on new submissions.
  • Files added or replaced when an entry is edited in the admin, File Upload fields inside a Repeater, and Post Image fields are not processed.
  • Non-Latin characters are removed from file and folder names.
  • Copies and resizing run while the form is submitted, so very large images make the submission take a little longer.
  • Not included: cropping or rotating images in the browser. Reordering files by drag and drop was added in 1.1.0.

Troubleshooting & FAQ

The image was refused but it is still listed under the field.

After a failed submission, Gravity Forms keeps the uploaded file so the visitor does not have to choose it again. Click the trash icon next to the file, choose a file that meets the rules and submit again.

Images are not resized and have no thumbnails.

Your server needs the GD or Imagick PHP image library. Go to Tools → Site Health → Info → Media Handling to check, or ask your host to enable one of them.

A merge tag in the file name is empty.

An empty answer is simply left out of the name. If the whole name ends up empty, the original file name is used.

Can a visitor upload a file type the field does not allow?

No. Upload Tools only works on files Gravity Forms has already accepted and never changes the extension. A file type WordPress does not allow in the Media Library is left out of the copies, and an entry note says so.

Is anything left behind if I uninstall?

Uninstalling through Gravity Forms removes the settings and the add-on’s entry data. Media Library files stay, because they may be used in your posts.

Resource Hub

Still need help?

Our support team answers tickets every day, usually within a few hours.

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr