👉 Get a free ITSM ebook

HubSpot Custom Fields

How to retrieve additional details from HubSpot database in a simple way? Find out below.

For the users to quickly access contacts from the HubSpot database, Jira work item can be linked with HubSpot objects by a custom field. Users can choose between single and multi-select fields.

How to create the custom field?

  1. Go to Settings (cog icon) > Work items > Fields.

Creating custom fields - accessing this option through global settings.

  1. Then select Create a field.

Creating a new custom field.

  1. Choose Advanced and select HubSpot Object Picker (Multi or Single).

Two options of HubSpot custom fields - single or multi-picker

  1. Click on Next button.

  2. Add name of choice, along with descriptions of the custom field.

Creating a custom field screen - adding a name and description.

In the new design of Atlassian's Jira, the HubSpot custom fields may not be listed in the Create field section. In this situation, users have to click Switch to an older experience. Then, they can easily find the field and continue the configuration.

Once the custom field is created, users need to remember to associate it with appropriate screens, such as Create work item, Work item view or Request form - the details for these examples are described below. After doing so, the field will be visible on the selected screens - the users can click on the contact and be transferred to the HubSpot database.

  • Then, just click on Create button.

HubSpot custom field configuration

  1. Click on the HubSpot custom field, in the Custom Fields list.

Accessing the context of the newly created custom field by clicking on the 'context' link in the custom list.

  1. Switch to Contexts tab and click Create, edit or delete contexts.

Editing the context of the custom field.

  1. There, select Edit custom field config.

Editing the custom field configuration.

  1. In the new window, users can choose between HubSpot objects that the field will be associated with to view information.

    1. Below, users can also select properties that can be displayed in the HubSpot CRM Integration panel in the work item view.

    2. The details can be also hidden by switching off the toggle at the top of the page.

List of properties that should be additionally displayed in the HubSpot panel in the Jira work items, based on the value in the custom field

Work Item View

In order to see the custom field on the Work item view, it has to be associated with project's default work item screen. After doing so, the field will appear in the Details panel on the right side. Users can search through the HubSpot database by typing an e-mail address or first/last name (for searching through Contacts), organization name (for Companies) and names (for Deals).

Additional information regarding values in HubSpot custom field can be viewed in the HubSpot CRM Integration panel on the right side.

Screenshot of a Jira work item view with a highlight on the HubSpot custom field in the Details section of the item.

Create Work Item View

The custom fields can be added to the Create screen, so that the object details are already included within the work item. In order to do so, when associating with screens, the Create work item screen, individual to the project, has to be selected. When done, the field will appear among others when creating a work item.

Create work item screen with added HubSpot custom field

Request Form View

The custom fields can also be present in the Request forms of JSM Service Desk projects. Details regarding configuration can be found here.

Screenshot of a request form on the JSM Service Desk with a highlighted HubSpot custom field, that has been added earlier.
PreviousHubSpot fields in Jira Service ManagementNextJira Data in HubSpot

Last updated

Was this helpful?