Skip to content

Property field types in HubSpot

Last updated: March 14, 2024

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

All products and plans

When you create a custom property in HubSpot, the type of information you want the property to collect and store will determine the field type to select. For certain field types, you can also edit the property’s type or options after the property is created.

Text input

The available text input properties are:

  • Single-line text: stores a single string of any alphanumeric characters, such as a word, a phrase, or a sentence. When the value is added through the CRM, the character limit is 65,536 characters. When the value is submitted through a form, there is no limit.
  • Multi-line text: stores multiple strings of alphanumeric characters, such as a paragraph or list of items. When the value is added through the CRM, the character limit is 65,536 characters. When the value is submitted through a form, there is no limit.
  • Phone number: stores phone numbers. This includes the default Phone number, Mobile phone number, and Fax properties, but you can also create custom phone number properties. Standard formatting and validation are automatically applied to phone numbers based on country code.

Choosing options

The available choosing options properties are:

  • Single checkbox: stores only two options, on or off. You can use this field type when you need a property with values that are true or false. In forms, they appear as a single checkbox.
  • Multiple checkboxes: stores checkboxes that contain several options. This is an enumeration property. Learn more about technical limits of enumeration properties.
  • Dropdown select: stores multiple options, where only one option can be selected as a value. In forms, they behave the same as radio select fields, but appear differently. This is an enumeration property. Learn more about technical limits of enumeration properties.
  • Radio select: stores multiple options, where only one option can be selected as a value. When editing on a record, they appear and behave the same as dropdown select fields. In forms, they behave the same as dropdown select fields, but appear differently. This is an enumeration property. Learn more about technical limits of enumeration properties.

dropdown-vs-radio-select-form

  • Date picker: stores a date value. In forms, they are used to allow visitors to input a specific date in a consistent format.

Please note: only date properties containing a day, month, and year can be manually created in settings. Datetime properties with a date and time can only be created via API. Learn more in the developer documentation


For enumeration properties (i.e. dropdown select, multiple checkboxes, radio select), the following technical limits apply:

  • Each option has a maximum of 3,000 characters, including its label, value, and description.
  • The maximum size of the property is 512,000 bytes, or 5,000 options, whichever is reached first.

Values

  • Number: stores a string of numerals or numbers written in decimal or scientific notation. You can select the formatting of a number property when creating or editing the property:
    • Formatted: formats the number with commas, for example 1,000,000. Formatted numbers should not exceed 15-16 digits in length.
    • Unformatted: removes number formatting, for example 1000000. 
    • Percentage: formats the number as a percentage, for example, 90%. Percentage property values are stored as decimals (e.g., 75% is stored as .75).
    • Currency: formats the number as a currency according to your account default currency settings.

Please note: you can only set lists and workflows to enroll based on whole integers, but if a record meets the criteria, even with a value including a decimal, it can still qualify for lists and workflows. For example, a contact with a value of -2.5 for a number property will enroll in a workflow with the enrollment trigger Number property is less than -2.

  • Calculation: stores equations based on properties of associated records, or based on properties in custom equations. Calculation properties cannot be used in forms and are available in Professional and Enterprise accounts only. Once created, the property's displayed field type will be either Equation, Rollup, or Calculation, depending on the type of calculation property you selected.
  • Score: stores a number based on custom scoring attributes, only available for contacts, companies, and deals. The number of Score properties you can create depends on your HubSpot subscription.

Other

  • File: stores a file associated with a record. In forms, visitors can upload any file type as part of their submission, with limits of 100MB for both single file and multiple file fields. The uploaded file's link will be available from the individual contact record. If a file isn't uploaded using a form, the property will be a single-line text property on a record. Learn more about supported file types in HubSpot.
  • HubSpot user: stores a list of users in your HubSpot account. Only one HubSpot user can be selected as a value. This field type can be used to create a custom owner property, separate from the default [Object] owner property. Users selected for this property will be treated as record owners, and will have the same edit permissions for the record as an owner. For example, you may want to create a "Point of contact" or "Collaborator" property to specify an additional user's role in relation to the record. You can create up to 50 custom HubSpot user properties. Learn more about assigning ownership of records and user permissions for records.
  • Rich text: stores stylized text and images. Format options include bold, italic, underline, text colors, font types and sizes, numbered and bulleted lists, paragraph indentation, hyperlinks, and images. By default, rich text data is rendered as a paragraph, so rich text property values are best used as separate paragraphs in your content rather than as inline text.
Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.