Gravity Forms File Renamer

How do I enable this functionality?

After installing and activating Gravity Forms File Renamer, files can be renamed in any File Upload or Post Image field in your forms. Let’s step through that process.

	Add a File Upload field to your form.
	Select the _Perks_ tab, and set up your Filename Template using Merge Tags.

Feature Details

Rename Uploaded Files

When using Gravity Forms, renaming uploaded files is simple with File Renamer.

• Files are renamed based on the Filename Template.
• Whatever is entered in the template will determine how the file is renamed.
• It accepts both static and dynamic content.
• Static content is typed into the field, and dynamic content is added via Merge Tags.

Add a Prefix or Suffix

Adding a prefix or suffix to filenames is easy with File Renamer. Start by adding the {filename} merge tag to your Filename Template. Then, add the prefix or suffix you want before or after the filename. For example, here I’m adding the suffix of -wizard to all uploaded files.

{filename}-wizard

Merge Tags

File Renamer supports using merge tags in filenames, allowing you to dynamically change the file upload text on upload. This includes both field merge tags and the {entry} merge tag. This lets you easily include identifiable, actionable entry data in the filename like the user’s first and last name and things like the entry ID.

On top of field and form merge tags, File Renamer also introduces special templating merge tags for renaming files.

Custom Upload Folder

Adding a slash ( / ) to your Filename Template will create a subfolder for that file to live in. You can use this to store files in a custom subfolder specific to the given form or entry. For example, this will store the uploaded files for each entry in a folder whose name is the entry ID.

{entry_id}/{filename}

Global Filename Template

File Renamer supports global filename templates using the gpfr_filename hook. A global filename template will apply to every file that is uploaded for any form. The gpfr_filename hook can also be used to target all uploads for a specific form or uploads for a specific field.

Integrations

File Upload Pro

File Renamer integrates with File Upload Pro to improve the file upload process. Uploaded files are automatically renamed when the form is submitted based on the configured naming template. If you’re using the {i} merge tag to increment files based on their order, File Upload Pro’s sorting feature lets the the user choose the file order.

Unique ID

With Unique ID, filenames can be given sequential numbers and unique alphanumeric IDs. Simply insert the Unique ID field’s merge tag into the File Template. There’s no additional configuration required.

Media Library

With Media Library, files are automatically uploaded to the WordPress Media Library. Files are renamed before being uploaded to the library, so files in the media library match your naming template.

Known Limitations

• Including post ID in filenames is not supported, as posts are generated after files are renamed.
• Files are uploaded before they are renamed. If you have uploaded files before activating File Renamer, some filenames may be deduplicated by Gravity Forms before File Renamer has renamed them.
• Custom upload paths are not supported when using GP Media Library.

Hooks

• gpfr_allow_whitespaces
  
• gpfr_filename
  
• gpfr_filename_template
  
• gpfr_ignore_extension
  
• gpfr_merge_tag_forward_slash_replace_char
  
• gpfr_replace_merge_tag_forward_slashes
  
• gpfr_sanitize_file_name_chars
  

Related Resources

• Add Image Previews to Gravity Forms File Upload Fields
  Learn how to add image previews to file upload fields when using GP File Upload Pro.
• Better File Uploads with Gravity Forms
  Improve the Gravity Forms File Upload field for a better user experience.
• Optimize and Offload Uploaded Files with Gravity Forms
  Automatically optimize images and offload files uploaded through Gravity Forms.