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.

This article requires the GP File Upload Pro perk.

Buy Gravity Perks to get this perk plus 47 other premium Gravity Forms plugins!

View Plugin Buy Gravity Perks


As a user I like to know that the file I’m uploading is the correct one. That’s why we built GF File Upload Pro. Among other features, it gives your users a visual confirmation of the file they’re about to send you.

Getting Started

Adding images previews is simple with File Upload Pro. Once activated, it will automatically add previews to any images uploaded to a Multi-File Upload field. File Upload Pro supports multiple ways to display your image previews and can be further customized with CSS. Your previews will shine!


    Step 1 – Add File Upload Field and Enable File Upload Pro

    Add a File Upload field to your form. Enable File Upload Pro in the Perks tab. Optionally enable Cropping and Sorting, if desired.

    Step 2 – Set Thumbnail Styles

    Default Thumbnails

    By default, File Upload Pro will show 48×48 pixel image thumbnails and show icons for files. This allows for images and files to be displayed attractively together.

    Mixed Thumbnails

    Large Thumbnails

    To increase the size of the thumbnails to 100×100 px, limit the Allowed file extensions in the field settings to only image files, such as .png,.jpg, and .gif

    Large Thumbnails

    Auto Thumbnails

    Limit the field to images only, as shown above, and enable cropping on the field to activate 100xAuto thumbnails. This shows your user exactly how the image was cropped.

    Auto Thumbnails

    Custom Thumbnails

    File Upload Pro uses sane CSS classes to make it easy to customize image thumbnails. This snippet is a simple example with large image previews, automatic letterboxing, and overlayed controls.

    Custom Thumbnails

    To use the snippet, paste it into the Additional CSS section of your theme.

    Rename files uploaded to Gravity Forms automatically.

    Gravity Forms File Renamer allows you to effortlessly rename any files uploaded with Gravity Forms. It’s powered by flexible naming templates, with support for static or dynamic values.

    Image Previews With Nested Forms

    If you use GF Nested Forms and want to display file previews in the Nested Forms field, you can by combining GF Media Library with this snippet.

    // Update 123 to your Child Form ID
    add_action( 'gpnf_fileupload_display_value_123', function ( $value ) {
    	$images         = GFAddOn::maybe_decode_json( $value['value'] );
    	$images         = gettype( $images ) == 'array' ? $images : [ $images ];
    	$value['label'] = '';
    	foreach ( $images as $img ) {
    		$url   = attachment_url_to_postid( $img );
    		$thumb = wp_get_attachment_image_src( $url );
    		$value['label'] .= '<img src="' . $thumb[0] . '" style="display: inline; width: 100px; margin-right:5px; margin-bottom: 5px;" />';
    	return $value;
    }, 10, 2 );

    Paste this snippet into your theme’s functions.php file and update “123” to your Child form’s ID. Then, activate GF Media Library on the File Upload field in your Child form. Any files that are uploaded to that File Upload field that have WordPress thumbnail support will automatically display in the Nested Form field.

    This snippet includes support for previewing PDF files in Nested Form fields.


    1. Ankit
      Ankit January 25, 2022 at 2:19 am

      Hello Team, I am using with some custom code here : to upload pictures in wordpress users gallery

      It is working fine when i upload images for the first time but when i again go back to modify uploaded images(ex: Delete any image) in my account then there is no image preview for my last time uploaded images it only ask to upload new images and when i upload new images it delete my old images.

      Can i show my users to see their old uploaded images in manage profile gallery form by Gravity form + ACF gallery

      1. Samuel Bassah
        Samuel Bassah Staff January 25, 2022 at 7:46 am

        Hi Ankit,

        The snippet alone won’t give you a preview of an already uploaded image. If you want to get a preview of the images, you’ll need to set up a GF User Registration Addon feed on the form and enable GP File Upload Pro Perk on the File Upload field. However, if you’re looking to display the images in a Gallery format, then I’ll suggest you checkout GravityView. In case this isn’t what you want, or it isn’t working for you, you can get in touch with us via our support form if you have an active Gravity Perks license so we can assist you further.


    2. Juan Luis Castro
      Juan Luis Castro January 5, 2022 at 8:41 pm

      Hello, I really like this plugin but it has a drawback and it is that it does not work with the featured images, when one is creating an entry in gravity, how can I make it work?

      1. Samuel Bassah
        Samuel Bassah Staff January 6, 2022 at 4:11 am

        Hi Juan,

        Unfortunately, I’m not really tracking your question very well. If what you’re trying to do is to update the featured image of a post created when a Gravity Form is submitted using the GF Advanced Post Creation addon, then what you can do is to set the ‘Maximum Number of Files’ property of the Multi-file upload field to 1. This makes it possible to select the Multi-File Upload field as the featured image in the GF APC feed. However, if this isn’t what you’re trying to do and you have an active Gravity Perks license, then you can get in touch with us via our support form so we can assist you further.


    3. J.
      J. June 30, 2021 at 2:06 pm


      I want to add image upload to my product page. Now this product has different sizes like 30×40 cm, 40×50 cm etc. So each size has a separate ratio.

      Is it possible to let customers choose a ratio, so they can precisely crop the image to the desired size? Customers should even be able to crop their image. If this is not done and we produce the product in a 30 x 40cm size and everything is cropped, you will get unhappy customers.

      1. Scott Ryer
        Scott Ryer Staff June 30, 2021 at 3:50 pm

        Hi J,

        You could add multiple File Upload fields to the form, each with a specific aspect ratio. You could then use Conditional Logic to hide/show the different fields based on a choice field.

    4. David Collins
      David Collins May 31, 2021 at 9:51 pm

      I need the preview image of uploaded files to display on the form once they are uploaded. Does this plugin do that?

      Also, what file types can be uploaded? I need .jpg .png .pdf and .mp4

      1. Samuel Bassah
        Samuel Bassah Staff June 1, 2021 at 10:51 am

        Hi David,

        Yes, with GP File Upload Pro, you would be able to preview the images that are uploaded and it supports all the file types allowed by the default Gravity Forms File Upload field, which includes all the file types you need.


    5. Erika
      Erika March 16, 2021 at 12:58 pm


      I was interested in the GP File Upload Pro plugin but I was wondering if there is a way to Enable File Upload Pro within the ‘Post Image’ Field?

      1. Ryan Donovan
        Ryan Donovan January 7, 2021 at 10:53 am

        Hello Seynt, Within the Post Image field you can set the image to be a featured image. Please let us know if you have any other questions. 😀

      MICHAEL LOEWENBERG January 4, 2021 at 2:37 am

      Hi. We are very interested in GF File Upload Pro. Do you have an estimated timeframe. Can we help you test it? We expect to have a high traffic volume scenerio, starting about Feb 15.


    7. Ivan L
      Ivan L December 22, 2020 at 2:12 pm

      Thank you for sharing this! I got the basic setup to work, but if the user submits the form with any error with the form (not necessarily with the image), a page with the errors highlighted, and the image doesn’t load. There’s nothing in “input.files”. How do I get access to that file on the updated page?

      1. Ryan Donovan
        Ryan Donovan December 22, 2020 at 2:19 pm

        Hello Ivan, what kind of errors are you seeing? Just the fields that have not been filled out or php errors on the top of your page? Let us know a little more about what you are seeing so we could help you out with this one. If you aer a Gravity Perks license holder you can reach out to our support here.

      1. Ryan Donovan
        Ryan Donovan July 14, 2020 at 11:48 am

        Hello Mirea, Sadly I cannot see that website as it requires a login. Could you please let us know a little more about your intent. 😃

    8. Viliam
      Viliam June 15, 2020 at 9:53 am


      what if I have more files upload fields. How make that, at all have a image preview?

      Thanks for answer

      1. Ryan Donovan
        Ryan Donovan June 15, 2020 at 10:41 am

        Hello Viliam, Thanks for writing in. As you can see, you can add multiple images if you have nested forms. We also have a new perk in the works, tentatively named GF File Upload Pro that will do just this and more. If you have a different use case and have a Gravity Perks license you can reach out to us through our support channel and we can see if we can find a solution for your forms.

      1. Joel
        Joel October 11, 2020 at 2:38 pm

        I would love Gravity View support. I have a form for users to create profile pictures. I’d love to be able to show them what they already have as an account profile picture and when they load their account form entry.

      2. Samuel Bassah
        Samuel Bassah Staff October 12, 2020 at 9:20 am

        Hi Joel,

        Previewing uploaded images on a single entry view is already supported by GravityView. Also, you may want to contact the GravityView Support team in case you experience any issues setting a preview on a View.


    9. Jurgen
      Jurgen March 24, 2020 at 4:38 am


      I managed to create a preview on a single image upload field. However I have 2 image upload fields. My customer doesn’t want to use the multiple file uploader.

      Do you know how I can create 2 seperate previews for 2 differente image upload fields?

      1. Ryan Donovan
        Ryan Donovan March 24, 2020 at 2:17 pm

        Hello Jurgen, This is an excellent question. Doing something like this would require some custom code. If you are a Gravity Perks License holder, could you drop us a support request and we could take a closer look at your forms setup? Thank you! 😀

    Comments are closed.

    Download Snippet

    Add Image Previews to Gravity Forms File Upload Fields

    This field is for validation purposes and should be left unchanged.