How to Change Record Images in HubSpot

Learning how to manage record images in Hubspot helps you quickly recognize contacts, companies, deals, and custom objects inside your CRM. This guide walks you through uploading, updating, and removing these images using the standard record image property.

Record images are small thumbnails shown at the top of a record and in certain views. They can make your database more visual and easier to scan, especially for client-facing teams and sales reps.

What Is a Record Image in HubSpot?

In HubSpot, a record image is a property used to display a small picture for an individual record. Depending on the object, this might be a contact photo, a company logo, or a visual icon for a custom object.

The platform uses a dedicated image field type called the Record image property. When configured correctly, this property lets you upload or change an image right from the record sidebar.

Supported HubSpot Objects for Record Images

You can use record images with several standard objects. The availability and behavior may vary slightly, but the concept is the same:

• Contacts – profile-style images for people.
• Companies – logos or brand icons.
• Deals – visual markers to distinguish deal types.
• Custom objects – any image that best represents your custom data.

Each of these object types can have a specific record image property set as the default image field for that object.

How the HubSpot Record Image Property Works

When you configure a record image property in HubSpot, you are essentially telling the system which image field should appear as the main thumbnail for that object. This is controlled in property settings for each object type.

The property itself is a file-type field that stores an image. Users can upload a new image, replace an existing one, or clear it directly from the record.

Default Record Image Logic in HubSpot

For many accounts, HubSpot may automatically set a default record image property, particularly for contacts and companies. However, admins can customize which property is used. If no default is configured, you may need to create or select a record image property before you see image controls on the record.

Set Up the Record Image Property in HubSpot

Before you change images on individual records, confirm that the correct property is configured. The following steps describe the general process for setting this up at the object level.

1. In your HubSpot account, go to Settings.

2. Navigate to Objects, then choose the object (for example, Contacts or Companies).

3. Open the Record customization or Properties area, depending on your account layout.

4. Locate the existing record image property, or create a new property with the image or file upload field type, following HubSpot’s property guidelines.

5. Set this property as the primary record image so that it appears in the header section of each record.

Once the property is configured, users will see the option to upload or change a record image directly from individual records.

How to Change an Existing Record Image in HubSpot

After the property is set, you can adjust images on single records. The process is similar across contacts, companies, deals, and custom objects.

Step-by-Step: Update a Record Image

1. Open the relevant object index page (for example, Contacts).

2. Click the name of the specific record whose image you want to edit.

3. In the record panel, move your cursor over the existing record image (or placeholder icon) near the top of the page.

4. Select the option to Edit or Change the image when it appears.

5. In the file picker, either:

   • Choose an existing image from your file manager, or

   • Upload a new image from your device.

6. Confirm your selection to apply the new image to the record.

The updated image will now display in the record header and other areas that reference the same property.

How to Upload a New Record Image in HubSpot

If a record does not yet have an image, you can upload one directly to the record image property.

Upload Instructions for HubSpot Records

1. Navigate to the record you want to update.

2. Hover over the placeholder image or the record image section.

3. Click the option to Upload or Add image.

4. Select an image file from your computer. For best results, follow HubSpot’s recommended image dimensions and file size guidelines described in the original documentation at this support article.

5. Save the change so the image appears immediately on the record.

You can repeat these steps for any other record you want to brand with a visual identifier.

How to Remove a Record Image in HubSpot

Sometimes you may need to remove an outdated or incorrect picture from a record. HubSpot lets you clear the image property without deleting the record itself.

Steps to Clear the Record Image

1. Open the record whose image you want to remove.

2. Hover over the existing image in the header.

3. Choose the option to Remove or Delete the image.

4. Confirm the action when prompted.

After removal, the property will revert to a default placeholder icon until you upload a new image.

Best Practices for Using Record Images in HubSpot

Using record images thoughtfully makes your CRM more intuitive. Consider these best practices when configuring the record image property and uploading files.

Choose Consistent Image Styles

For a clean interface, maintain consistency across your images:

• Use similar aspect ratios, such as square images for all contacts.

• Align background styles, like solid colors or transparent PNGs.

• Stay within your brand guidelines for logos and headshots.

Optimize File Size and Format

HubSpot supports common image types, but smaller, optimized files help your CRM load faster. Consider:

• Compressing images before uploading.

• Using modern formats like optimized JPEG or PNG.

• Keeping dimensions close to what HubSpot displays to avoid unnecessary scaling.

Define a Process for Updating Images

To keep record images accurate:

• Assign ownership to team members responsible for maintaining visuals.

• Update images when a logo changes or a contact switches roles.

• Periodically audit important records to ensure images still match reality.

Troubleshooting Record Images in HubSpot

If the image is not appearing as expected, check the following points before escalating to technical support.

Record Image Property Not Visible

If you do not see the image section on a record:

• Confirm that a record image property is configured for that object in settings.

• Verify that your user has permission to view and edit properties on that object.

• Check whether the property is included on the record layout sidebar for that pipeline or object configuration.

Image Not Updating After Upload

If a new image does not appear immediately:

• Refresh the record page to clear browser caching.

• Confirm you clicked Save or Done after selecting the file.

• Try a different browser or incognito window to rule out cache or extension conflicts.

When to Consult Advanced HubSpot Experts

For complex CRM setups, you might want help integrating record images into custom objects, advanced automation, or external systems. For strategic guidance on CRM optimization and marketing operations beyond what standard HubSpot documentation covers, you can work with specialized consultants such as Consultevo.

By configuring the record image property correctly and following the steps outlined above, you can keep your HubSpot records visually organized, easier to scan, and more aligned with your brand.

Need Help With Hubspot?

If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.

Scale Hubspot

“`