How to Create and Edit HubSpot Properties

Learn the process of creating, editing, and managing properties within HubSpot records.

Properties are fields that store information on HubSpot records. For example, you can use the City company property to specify where companies are located. There are default properties included for each object, but you can create custom properties to store unique data for your business.

You should check whether a default property can meet your data requirements before creating a custom property. Learn more about the default properties for contacts, companies, deals, tickets, and feedback submissions.

You can also clone, delete, and export properties from your settings. If you want to view or update values for properties, learn how to edit property values on a record or in bulk.

Here's a step-by-step guide on creating and editing properties:

Launch your HubSpot account and navigate to the ⚙️ settings icon displayed in the main navigation bar.
In the left-hand sidebar menu, navigate to Properties.
Click the Select an object dropdown menu, thereby selecting the [Object] properties, to create or edit a property for that object.

select-an-object-properties

To locate specific properties:
- In the upper left, use the dropdown menus to filter by property group, field type, or which user created the property.

- In the upper right, enter the name of a property in the search box to find a specific property.

- To sort your properties, click a column header.

property-filters

To create a property, in the upper right, click Create property. To edit an existing property, click a property’s name in the table. Some properties cannot be edited, including certain default properties, or properties in use on records or in HubSpot tools, such as lists or workflows.

Please note: you must have Edit property settings permissions to create or edit properties. The number of custom properties you can create depends on your HubSpot subscription. If you downgrade to HubSpot's free tools, you can view and edit existing custom properties but cannot create new properties if you already exceed the limit.

In the right panel, set or edit the property’s basic information:
- Object type: if creating a property, select the object that will store the property. By default, this is the object you selected earlier. Object type cannot be edited once saved.
- Group: select the property group that the property will belong to. A property group is a label used to group similar properties within an object. These are used only within the properties settings.
- Label/Name: enter a unique name for the property. This is the name of the property as it appears in your HubSpot CRM, including on records and index pages. Since you can edit a property's label, the label should not be used for integrations and APIs. For example, Company name is a property label.
- Internal name: click the </> code icon to set or view the internal name for the property. Once a property is created, the internal name cannot be edited. Since the internal value of a property will never change, it should be used for integrations and APIs rather than the property label. For example, the internal name for the Company name property is name.
- Description: While non-mandatory, this text box serves as a platform to describe the property's nature.

create-property-details

edit-property-basic-info

If you’re creating a new property, click Next. If you’re editing a property, navigate to the Field type tab.
To set or edit the property’s field type, click the Field type dropdown menu, then select a field type for the property.

Please note: changing an existing property’s field type can invalidate current values stored in the property. It is recommended to export all information prior to editing a property's field type. A property's field type cannot be edited to Score, Calculation, or Date, and properties of those types cannot be edited to another field type.

There are additional steps that appear when you select certain field types:
- Number: select the format the values should be in. Options include Formatted number, Unformatted number, or Currency.
- Calculation or Score: click Build [calculation/score], then set up your calculation property or score property criteria.
- Multiple checkboxes, Dropdown select, or Radio select:
  - Enter or edit the different options for the property:
    - Label: enter the name of the option. The option's Internal value is automatically generated based on the label.
    - In forms: click to toggle the switch on to include the option for forms
    - + Add an option: click to add a new option.
    - Load options...: click to load multiple options at once. You can select a default set of options, such as Country and Timezone, paste text to create options in bulk, or copy the options from an existing property.
    - Clear all: click to remove all existing options.

property-field-type-with-options

- - To edit the options in bulk, select the checkboxes next to the options. At the top of the table, select:
    - Hide in forms: click to hide the selected property values from appearing in your HubSpot forms as options.
    - Merge: click to merge the selected property values. This will result in the merged values being removed from the property, leaving one value. This may affect integrations and tools that rely on a specific property value, such as list and workflow filters.
    - Delete: click to delete the selected property values.
  - Click and drag the drag handle to manually reorder the options, or click the Sort dropdown menu and select Custom or Alphabetical.

If you’re creating a new property, click Next. If you’re editing a property, navigate to the Rules tab.
Set or edit rules for your property:
- By default, properties are included as field options in your HubSpot forms, pop-up forms, and bots. If you don't want the property to be an option, clear the Show in forms, pop-up forms, and bots checkbox. Product properties cannot be included in forms or bots.
- There are additional rules you can set for Single-line text, Multi-line text, and Number properties:
  - For company, deal, ticket, or custom object properties, select the checkbox to require unique values for the property. With this turned on, users will be unable to enter the same value for multiple records. You can create up to ten unique value properties per object.
  - Select the Show in search checkbox (Enterprise only) to make values in the property searchable across objects in the global search bar. You can create up to three searchable properties per object. This option does not appear when creating or editing custom object properties because all custom object properties are searchable by default.
  - For deal currency properties, by default, the currency format uses your company currency. If your account uses multiple currencies, to set up a property that's based on each deal's currency, select the Use record currency instead of company currency checkbox. Learn more about using multiple currencies with deals.
  - Select or clear the checkboxes to set or edit the property's validation rules.
Once you’re done, click Create or Save at the bottom of the panel.