Skip to main content
Version: v6

How to show uploaded images in Core / Universal PDFs

By default, Gravity PDF displays all files uploaded using the File Upload field as a bullet point list with links to those files.

The File Upload Field displaying a list of uploaded files in Core / Universal PDFs The File Upload Field displaying a list of uploaded files in Core / Universal PDFs

Out of the box it isn't possible to display uploaded images in the Core (free) or Universal (paid) PDFs, and we've done this for technical reasons: loading more than 10MB of images (less on some shared hosting) can cause significant PDF generation times, or PHP fatal errors like timeouts or hitting the PHP memory limit. And images may appear incorrectly rotated because the PDF engine doesn't read an image's EXIF rotational data, which affects images captured on mobile or tablet devices.

To overcome all these problems and display / show / embed uploaded images in Gravity PDF, we recommend the Image Hopper add-on. This plugin can be configured to automatically downsize images and it will auto-rotate them by reading the EXIF data so the PDF will display them correctly. This all happens directly in the client's browser (and not on the server), which significantly reduces the chance of server-related problems while generating PDFs that include these images and has the added bonus of faster upload times for your users and reduced bandwidth and file storage usage for your website.

The form editor with an Image Hopper field selected Where to find the Image Hopper field in the Form Editor

Once installed, add a new Image Hopper field to your Gravity Form. Just make sure to set the Downscale Images width and height setting to no more than 1000x1000px to prevent the aforementioned image size issue. Gravity PDF will now automatically display / show the uploaded images in the Core / Universal PDFs.

A Gravity PDF-generated document with images included thanks to Image Hopper The Image Hopper Field displays images in Core / Universal PDFs automatically

note

Previously we recommend using the Slim Image Cropper for Gravity Forms plugin, but it was discontinued by its developer.

Video Walkthrough

If you enjoy learning through video, you can watch this 12-minute video with Gravity PDF's lead developer showing you how to include user uploaded images in the Core and Universal PDF templates using both the File Upload field and the amazing Image Hopper plugin.