Property field types in HubSpot
Last updated: February 26, 2024
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.
- 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.
- 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.
- 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 or Rollup, depending on the type of calculation property you selected. If you create a custom equation, the following output types are available based on how you create the calculated property:
- 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.
- 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. 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 50 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.