Skip to content

Property field types in HubSpot

Last updated: August 21, 2023

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

  • 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

  • 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, with a maximum of 5000 options. Each option has a maximum of 3,000 characters, including its label, value, and description. This is an enumeration property.
  • Dropdown select: stores up to 5000 options, where only one option can be selected as a value. Each option has a maximum of 3,000 characters, including its label, value, and description. In forms, they behave the same as radio select fields, but appear differently. This is an enumeration property.
  • Radio select: stores up to 5000 options, where only one option can be selected as a value. Each option has a maximum of 3,000 characters, including its label, value, and description. 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.
  • 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


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. 
    • 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 custom equations based on number properties. 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 or Rollup, depending on the calculated property type 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. 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. For example, you may want to create a "Point of contact" or "Collaborator" property for which you can select a user as an additional owner and specify their role in relation to the record. You can create up to 30 custom HubSpot user properties. Learn more about assigning ownership of 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.