Image Display for File Properties
Tuesday, October 27, 2026
What it is
File properties can now display image thumbnails directly on a CRM card, a CRM record and index pages. Images stored in these properties are also available as personalization tokens for use in marketing emails and CMS content.
Why it matters
Teams that rely on images stored in HubSpot, from real estate listings to insurance claims, currently have no way to see those images without leaving the record to open a file link. This update brings images into the CRM view where your team is already working, so you can identify records at a glance and use those images in your outreach without re-uploading or manually syncing files. Any marketing emails using these images will automatically reflect the latest version of the file stored on the record. No manual updates needed.
The Take
Never thought I'd be excited about file properties in the way that I am now.
“I will be using that” was my first reaction reading the panel, and Ryan was right there with me: “today, I have [an] actual use case for that right now.”
What makes it land for me is what we used to build. I asked Ryan if he remembered how we had to build everything to do this, and he went straight to a project we were on, where we created a custom UI extension that let them upload the image, edit the name and toggle through all of the file properties in a carousel. Cool, solved. Ryan has a client right now with another system putting invoices into the company records so people can get quick access to the PDF. Their limitation is a UI extension with a quick action to create the email, and that quick action can't set body content with images in the current state. Ryan's read is that with this they can simply put in the property token and send the email.
The part I care about most is the AI side, and that is my reasoning, not something the panel says. I am always thinking about AI being able to see what's on the page and literally see it. Before this, if a file property was there, however Breeze was handling it, it had to open the file as a PDF, open it in a new tab or download it itself, so the image was not on the page with everything else. Those context switches are points of risk, or missing context when you are switching back and forth. That was the last layer, and it is a huge deal. The panel says nothing about Breeze, so whether Breeze reads the new thumbnails is my inference until I test it.
What to do: image display is opt-in per property, so nothing changes in your portal until you edit a property and check Display uploaded images in the Rules section. New file properties created while in the beta get it automatically. One more thing I called a sneaky update: clicking any file link on a file property, even one you have not opted in, opens a new File details panel with a larger image preview and file metadata. If you store listing photos, product images or claim documents in file properties, join the beta and try it this week. If you do not, you can skip it. It is in public beta, and the panel showed Join beta when we opened it.
FAQ
What does it change on a record?
File properties with image display enabled show image thumbnails inline on the record page and index page, hovering over a thumbnail shows a larger preview, and the images are available as personalization tokens in marketing emails and CMS content.
Do I have to turn it on, and how?
Yes for existing properties. Image display is opt-in per property so your existing file property experience is not disrupted. Edit the property and check Display uploaded images in the Rules section. Per the panel, new file properties created while in the beta have image display enabled automatically.
What happens to emails that use these images?
Per the panel, any marketing emails using these images automatically reflect the latest version of the file stored on the record, with no manual updates needed.
Who gets it, and is it live?
All hubs and tiers. It is in public beta, and the panel showed Join beta when it was opened on air. Per the panel, file encryption and sensitive data handling apply to image-enabled file properties the same way they do for all file properties.
Produced by Value-First Media