Black Magic Black Friday Sale! • Basic 10%, Advanced 25%, Pro 50% off • Coupon: BLACKMAGIC • Buy Now!

Gravity Wiz

Magically enhanced tutorials, snippets and plugins for Gravity Forms!

Rename Uploaded Files For Gravity Forms

Rename uploaded files for Gravity Forms. You can create a static naming template or using merge tags to base names on user input.

Last updated | Written by 380 Comments

  • March 23, 2022: Fixed issue where editing entries belonging to forms with multiple GW_Rename_Uploaded_Files on the same form would cause files to be re-renamed.

  • March 12, 2021: Added ignore_extension option.

  • June 12, 2020: Improved support for non-latin characters.

  • 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

Show All Updates
View CodeDownload Code

Stop! There's a better way.

This snippet is available as a plugin with Gravity Perks, a suite of over 44 premium Gravity Forms plugins!

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
  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

new GW_Rename_Uploaded_Files( array(
	'form_id'  => 628,
	'field_id' => 3,
	'template' => '{Name (First):1.3}-{Name (Last):1.6}-{filename}', // most merge tags are supported, original file extension is preserved
) );

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

new GW_Rename_Uploaded_Files( array(
	'form_id'  => 12,
	'field_id' => 18,
	'template' => '{form_title}-{filename}', // most merge tags are supported, original file extension is preserved
) );

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

new GW_Rename_Uploaded_Files( array(
	'form_id'  => 628,
	'field_id' => 5,
	'template' => 'static-file-name',
) );

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

Ignore Extension

new GW_Rename_Uploaded_Files( array(
	'form_id'          => 628,
	'field_id'         => 5,
	'template'         => 'static-file-name',
	'ignore_extension' => true,
) );

By default, this snippet takes the extension into consideration when renaming files. For example, static-file-name.jpg is different from static-file-name.png. You can change this behavior to ignore the extension of a file so in this scenario static-file-name.png would be renamed to static-file-name1.png as there’s already a static-file-name file uploaded.

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.

You never need to include the file extension in your template. It will automatically be included.

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!

Did this resource help you do something awesome with Gravity Forms? Then you'll absolutely love Gravity Perks; a suite of 43+ essential add-ons for Gravity Forms with support you can count on.

Comments

  1. Omar says

    When I add the snippet through code snippets plugin it is showing the following error: The code snippet you are trying to save produced a fatal error on line 1:

    Uncaught Error: Class ‘GW_Rename_Uploaded_Files’ not found in /home/XXXX…..

    Did I miss something?

    Reply

    • Joao Angeline says

      Hi Omar!

      Thanks for your comment. We are sorry you are facing this issue with our snippet.

      We would like to take a look at your snippet added through the Code Snippet plugin. If you have a Gravity Perks license, can you get in touch with us via our support form?

  2. Arden says

    Hello, how to avoid changing the name with a number in the same extension, or rather how to rename again and again the same file with the same extension.

    Example: Want to avoid this: a.jpg, a1.jpg, a2.jpg.

    You want to achieve this: a.jpg, a.jpg, a.jpg, a.jpg

    Reply

    • Dario Space says

      Hi Arden,

      It seems this is not currently supported and it will require some customization. If you have a Gravity Perks license, can you get in touch with us via our support form?

      Cheers,

    • Dario Space says

      Hi Todd,

      It should work when multiple uploads are enabled. About the dropbox add on integration tou can get in touch with us via our support form if you have an active Gravity Perks license, so we can take a look at your setup and assist you to set it up.

    • Samuel Bassah says

      Hi Jasim,

      To rename two or more files on the same form, you have to duplicate the configuration and update the IDs accordingly. Here is an article with details on how to do this.

      Best,

    • Samuel Bassah says

      Hi Muhammed,

      You can’t have a white space in a filename, because WordPress would replace it with a dash and it will also sanitize any special character including brackets by removing them.

      Best,

  6. d s says

    Hello. This is a great snippet, thanks so much for making it available. I do have one issue, though:

    I am prepending unique identifiers to file names in files uploaded by customers. That part is working great. However, administrators utilize GravityView to access the same form wherein they will occasionally make an edit to other entries. When that happens, even if it’s an edit to a totally unrelated entry, the renamed files get renamed all over again. For example, a file may start out as IMG1000.jpg, it gets uploaded and renamed to unique_identifier_IMG1000.jpg, but then it gets renamed yet again to unique_identifier_unique_identifier_IMG1000.jpg if the administrator edits any entry in the form. Is there a way to prevent this renaming duplication from happening? Thanks in advance for your help.

    Reply

    • Samuel Bassah says

      Hi,

      I am unable to recreate this issue so I have sent you an email to request more information. Please check and reply.

      Best,

  8. Nicola says

    Hi, I have more than 20 forms and each of them allows to upload up to 5 images, is it possible to make the code dynamic so that it works throughout the site? Or are there other solutions (apart from having to maintain 100 different snippets).

    Thanks, Nicola

    Reply

    • Samuel Bassah says

      Hi Nicola,

      If you want to use the file rename snippet on more than one file upload field and on multiple forms, you only have to set up multiple configurations. You don’t have to duplicate the entire snippet, but just the configuration part which will create multiple instances of the Class. Here is an article on how to apply a class-based snippet multiple times.

      I hope this helps.

      Best,

  9. J A McRae says

    Can anyone think of a way i can get the category slug instead of the category name? This is for a contest entry, so to make a random number, I’m grabbing some mixed up time stamp. ($result = $date->format(‘uYHmids’);)

    ‘template’ => ‘{Category:9}-‘.$result,

    Field 9 on my form is the Post field Category, but i’d prefer to pull in the slug instead Could there be a hidden field on the form maybe that i could use to populate with the category slug once the user fills in the Category field?

    Or any other thoughts?

    J A

    Reply

  10. Steve says

    as per initial comment – how do we use on more than one form? is that possible – appears you can set multiple configurations but not sure if that is just that part of the code or does all of the code require duplication with appropriate settings – got it to work with form A) now want to also use for form B) – thanks in advance – cool snippet (appreciate the share)

    Reply

    • Samuel Bassah says

      Hi Steve,

      To use the snippet on more than one form, you only have to set up multiple configurations. You don’t have to duplicate the entire code. You can read more about here.

  11. cat3media@gmail.com Levy says

    Question: How do I modify this to include multiple instances. I have one form with 3 different file upload fields. Need different naming conventions for each field.

    Reply

    • Dario Space says

      Hi,

      We’ve already followed up via email. If you have more than one field per form, you will need to create as many configurations as fields you have.

      Best,

  12. mohamed sabri says

    I have a question

    When I add the code in function.php file, it’s work correctly and rename any file i Upload it

    but it’s work only when i create new gravity form with file upload

    old forms i was created before add the code it’s not work its rename a file like name-first1-3.jpg

    how can i make the code work with old form i have ?

    Reply

    • Samuel Bassah says

      Hi Mohamed,

      That’s strange because the snippet should work on old forms without any issue. You may want to check the configuration to see if you’re passing the right parameters. In case it’s still not working, you can get in touch with us via our support form if you have an active Gravity Perks license, so we can dig into this further.

      Best,

Leave a Reply

Your email address will not be published. Required fields are marked *

By commenting, I understand that I may receive emails related to Gravity Wiz and can unsubscribe at any time.