Create custom properties

Last updated: March 27, 2019

In HubSpot, properties store information about a contact, company, deal, or ticket. Your HubSpot account includes a number of contact, companydeal, and ticket properties by default. However, you may need additional properties to gather information for your business's marketing, sales, and service processes. You can have up to 1,000 properties per object, including default properties provided by HubSpot.

To create a new custom property: 

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to Properties.
  • Click the tab of the object type to create the property for.
  • In the upper right, click Create a property.
  • In the right panel, set up your property: 
    1. Label: enter a name for the property that will appear internally on records. The label will also be the external default form field label for the property when used as a field on a HubSpot form.
    2. Internal name: edit the API identifier for the property. This is unique and not editable once the property is created. It's automatically determined based on the original label that you set for a contact property. If the custom property is created by the Salesforce connector, HubSpot automatically appends a "__c" to the end of the HubSpot property name (Salesforce custom field names also use the same naming convention).
    3. Please note: when the error A contact property already exists with that name. Please try a different name. appears, the current internal name is already used. Update the current property's Internal name to save your new property.
    4. Description: enter a short explanation of the property. This is only for internal use only.
    5. Group: select a default group or one of your custom groups. Your properties are all stored in groups so that you can keep them organized
    6. Field type: select a field type for your property based on the type of information you'll be gathering.
    7. Please note: once a ScoreCalculated, or Date property is created, its field type cannot be edited.
    8. Show in forms: clear the Show in forms box if you don't want the property to be available for use in forms, pop-up forms, and bots. This is enabled by default.
    9. Add to search (Enterprise only)for a single-line text, multi-line text, or number property, select the Add to search checkbox to allow users to be able to search values in this property.
  • Click Create.

You can also set your custom properties to appear in the About section of records by default.