Skip to content
English
  • There are no suggestions because the search field is empty.

Understanding Front-Facing Labels vs. Internal Names in HubSpot Data Connections | Connector/Database Sync

This article explains the difference between front-facing labels as seen in the HubSpot user interface and internal property names used by the HubSpot API that is seen in your provided dataset. 

It also outlines how the distinction affects data pulled into the dataset provided by the Connector and Database Sync apps. Understanding this difference is important when reviewing datasets generated from your HubSpot portal via either app. 

Understanding Labels and Internal Names

In the context of data connections, particularly when using HubSpot, it is important to differentiate between front-facing labels and internal names. The internal names are the identifiers used by the HubSpot API, while the front-facing labels are what users typically see in the HubSpot user interface.

Key Points

  • Internal Names: When data is pulled from HubSpot and then stored into a database by either the Connector or Database Sync app, it primarily uses internal names for properties and values. These internal names are essential for identifying fields within the database.

  • Front-Facing Labels: The actual front-facing labels, which users see in the HubSpot UI, do not typically reside in the dataset provided by our apps. The API provided by HubSpot references only the internal names, making it challenging to retrieve the corresponding labels directly.

Context when using our Connector/Database Sync apps

When using our Connector or Database Sync apps, the apps will pull in and display the names of fields/columns/properties from HubSpot into your respective dataset based on their internal (API) names.

In order to confirm which column/field in your dataset corresponds to which property in your HubSpot portal, you will need to reference the internal name of the property in your property settings in HubSpot and cross-reference that with what you see in the provided dataset.

You can refer to the help guide located at the bottom of the page if you do not know how to locate the internal names of properties in HubSpot.

Exceptions to the use of labels vs internal names

While internal names are used in most cases, there are some exceptions.

1. DealStageHistory and TicketStageHistory Tables

In the following tables:

  • DealStageHistory

  • TicketStageHistory

The column headers that indicate when a record changes stages will contain the label of the corresponding stage, rather than the internal name.

2. Certain Property Value Types

For specific field types, the Connector can return labels for values instead of internal values within cells.

This applies to the following property types:

  • Multiple checkbox

  • Radio select

  • Dropdown select

For these property types, the dataset may display the label of the selected value in its respective cell rather than its internal API value.

Conclusion

In summary, while the Connector and Database Sync apps primarily pulls in internal names of properties from HubSpot into your respective dataset, front-facing labels are typically not included. To locate the internal names of properties, please refer to help guide linked below: