HubSpot by IV-Lead

Understand Property Field Types in HubSpot

Written by Ohad Peter | Sep 22, 2025 9:32:06 AM

When you create a custom property in HubSpot, you select the field type based on the type of information you want to collect and store. The type or options of some fields can be changed after the property has been created, depending on the field type.

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. Adding values through the CRM has a limit of 65,536 characters. Forms do not limit the value that can be submitted.
  • 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. There is no limit when the value is submitted through a form.

Please note: Some tools, such as marketing emails, quotes, and sequences, do not support line breaks in multi-line text property values. The addition of line breaks can be automated in your account if you subscribe to Data Hub.

  • Phone number: stores phone numbers. You can create custom phone number properties in addition to the default Phone number, Mobile phone number, and Fax number properties. Based on the country code, standard formatting and validation are automatically applied to phone numbers.

Choosing options

The available choosing options properties are:

  • Single checkbox: stores only two options, on or off. When you need a property with true or false values, you can use this field type. Forms display them as a single checkbox.
  • Multiple checkboxes: stores checkboxes that contain several options. This is an enumeration property. Discover the technical limits of enumeration properties.
  • Dropdown select: stores multiple options, where only one option can be selected as a value. Their behavior is similar to radio select fields, but their appearance is different. 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. Their appearance and behavior are similar to those of dropdown select fields when editing a record. Unlike dropdown select fields, they appear differently on forms. This is an enumeration property. Learn more about technical limits of enumeration properties.

 

  • Date picker: stores a date value. It is possible to display only date or also relative time. Forms use them to allow visitors to input a specific date consistently.
  • Date and time picker: stores a date and time value. In addition to date and time, you can also display relative time. User's current time zone is used when viewing and editing date and time properties, based on their device's time zone. A user's time zone is used by default when filtering. 

Please note: In legacy forms, date and time picker properties will only display dates and will not populate their values in CRM.y. With the updated form builder, date and time properties cannot be added. Due to these reasons, it is recommended to use date picker properties instead.

 

Embedded enumeration properties (such as dropdown selections, multiple checkboxes, radio buttons) are subject to the following technical limitations:

  • Including a label, value, and description, each option can have a maximum of 3,000 characters.
  • In total, 512,000 bytes can be stored in the property, or 5,000 options if the property reaches that limit first.

Values

  • Number: stores a string of numerals or numbers written in decimal or scientific notation. When creating or editing a number property, you can select the formatting:
    • Formatted: formats the number with commas, for example 1,000,000. The length of formatted numbers should not exceed 20 digits. The numbers will be displayed in exponential notation after 20 digits.
    • Unformatted: Removes number formatting, such as 1000000. Unformatted numbers are treated as strings, so they can have a large number of digits. In reports, values should not exceed 38 digits, 10 of which can be to the right of the decimal place, for best results. 
    • 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: Workflows and segments can only enroll records based on whole integers, but records containing decimals can still qualify if they meet the criteria. A contact with a number property value of -2.5 will enroll in a workflow with the enrollment trigger Number property is less than -2.

  • Calculation: Equations can be stored based on properties of associated records, or based on properties of custom equations. Forms cannot be used with calculation properties, which are only available in Professional and Enterprise accounts. 
  • Rollup: stores a value. Based on the rollup type, it calculates the property values of all records of a selected object. There are five types of data: Min, Max, Count, Sum, and Average. (e.g., the count of all associated companies create dates). A variety of format options are available, including; Formatted, Unformatted, Currency, Percentage, and Duration. To get the count of all associated companies based on their creation dates, you can create a rollup property.
  • Score (legacy): stores a number based on custom scoring attributes, only available for contacts, companies, and deals. Depending on your HubSpot subscription, you can create a certain number of Score properties. Forms cannot use score properties.

Other

  • Property sync(Professional and Enterprise only): stores a value synced from a property on an associated record. As soon as the selected property on the associated record is set or changed, the sync property value is automatically updated. Learn how to set up a sync property.
  • File: stores files associated with a record. Users can upload files when creating or editing records. By submitting a form, visitors can upload a file. There can be up to 10 files in each file property. Accounts with free tools can upload files up to 20 MB, and accounts with paid subscriptions can upload files up to 50 MB. An uploaded file cannot exceed 100MB, and the link to the file can be found in the contact record of the submitter. You can choose who can view files uploaded to a file property when creating it. Learn more about supported file types in HubSpot.
  • HubSpot user: stores a list of users in your HubSpot account. One or many HubSpot users can be selected. 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. User properties cannot be used in forms. Learn more about assigning ownership of records and user permissions for records.
  • URL: stores an appropriately formatted URL link (e.g., https://www.yourdomain.com). It is possible to specify a list of domains that should be allowed or blocked. You will automatically add https:// to the beginning of a value when you enter it. Values that do not fit the valid URL format cannot be saved. In the CRM, URL property values can be clicked (for example, when displayed on an index page). URL properties cannot be used in forms.
  • Rich text: stores stylized text and images. You can format your text with bold, italic, underline, colors, fonts, bulleted and numbered lists, paragraph indentation, hyperlinks, and images. Since rich text data is rendered as a paragraph by default, it is best to use rich text property values as separate paragraphs rather than inline text. In inserting images, the maximum size is determined by the amount of data in the image rather than by the number of pixels. 64 KB is the maximum size of the property value, including images. Forms cannot use rich text properties.