Skip to content
HubSpot Knowledge Base

Sync Salesforce reference fields

Last updated: January 20, 2026

Available with any of the following subscriptions, except where noted:

Salesforce reference field values sync to HubSpot as 18-digit record IDs, not as labels. Although HubSpot can't automatically retrieve these labels, you can map Salesforce reference fields to a HubSpot dropdown property to make the values usable for segmentation and reporting in HubSpot. 

Map Salesforce reference fields to HubSpot

  1. In your HubSpot account, create a HubSpot custom property with a dropdown select field type.
  2. Map the Salesforce reference field to the newly-created HubSpot custom property.
  3. In your HubSpot account, click the settings settings icon in the top navigation bar.
  4. In the left sidebar menu, navigate to Properties.
  5. Click the name of the custom property used in the field mapping.
  6. In the left sidebar menu, click Field type. 
  7. In the Dropdown options section, the Internal name column will display the 18-digit record ID for each reference field value from Salesforce. Enter the corresponding field value labels from Salesforce in the Label fields.
  8. In the top right, click Save.

You'll now be able to segment the reference field based on the field value labels, instead of the field value record IDs.

Please note: this method requires ongoing maintenance. If a new value is added to the Salesforce reference field, the label of the corresponding option in the HubSpot property must be manually edited following the steps above.
Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.

Related content

Table of contents /salesforce/how-do-i-sync-a-salesforce-reference-field Menu

Related content

New to HubSpot? Use these guides to get started.