Rename Uploaded Files For Gravity Forms

• Jun 27, 2018: Updated to use get_upload_dir() method instead of wp_upload_dir().

• November 19th, 2016: Fixed typo in method name.

• October 24, 2016: Fixed issue with Gravity Forms 2.0.7. Major refactor. Requires Gravity Forms 2.0.7.15 or greater.

• December 5, 2015: Added support for Post Image fields.

• September 22, 2015: Updated to remove forward and backslashes from new filename.

• March 26, 2015: Fixed issue when submitting form with no uploaded files

We wrote a snippet that will allow you to create a dynamic naming template for your uploaded Gravity Form files. This includes the ability to prepend, append or generate from scratch custom file names. You can use merge tags to include user input in your new file names.

Here are a couple use cases where this snippet might be useful:

1. Include the name of the submitting user either before or after the file name.
2. Include an event name in the file name to better categorize which files belong to which events.

For example, given an original file name of mountains.png and a template of {Name (First):1.3}-{Name (Last):1.6}-{filename}, the final image name would be Jordan-Smith-mountains.png

Getting Started

1. Check requirements
   • Make sure you have Gravity Forms installed and activated.
     • Already have a license? Download Latest Gravity Forms
     • Need a license? Buy Gravity Forms
2. Install the snippet
   • Copy and paste the entire snippet into your theme’s functions.php file.
3. Configure the snippet
   • Once you have installed the snippet, find the snippet configuration section located at the bottom of the snippet code.
   • Replace the form_id with the ID of your form.
   • Replace the field_id with the field ID of your File Upload field.
   • Replace the template with your custom file name template.

Usage Examples

First and Last Name

In this example, we are prepending the first and last name from the form to easily identify who submitted the file. Most merge tags are supported using this method and the original file extension is preserved.

Form Title Merge Tag

In this example, we are prepending the title of the form to the filename to quickly identify which form the file was uploaded to.

Static Text

You can use any text you’d like, just make sure to add the {filename} merge tag somewhere in there.

Parameters

• form_id (integer) (required)

  Your Form ID. There is no default value.

• field_id (integer) (required)

  The Field ID of the file upload field. There is no default value.

• template (string or merge tag) (required)

  This is the template that controls how the file will be rewritten. The value can be either a static string or a merge-tag(s). There is no default value.

Was this helpful?

We hope you find this snippet useful! If you do, show us some love by sharing this article on the social media platform of your choice. Let’s keep the Gravity Wiz pumping out awesome snippets. Thanks!