Property field types in HubSpot
Last updated: August 27, 2024
Available with any of the following subscriptions, except where noted:
|
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.
- Date picker: stores a date value. In forms, they are used to allow visitors to input a specific date in a consistent format.
- Date and time picker: stores a date and time value. When viewing and editing a date and time property, a user’s current time zone is used, based on the time zone of the user's device. When filtering, the account’s time zone is used by default.
Please note: if used in forms, date and time picker properties will only display dates and will not populate the property value in the CRM. If you're using the new form builder (BETA), date and time properties cannot currently be added to a form. For these reasons, it's recommended to use date picker properties in your forms instead.
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. Score properties cannot be used in forms.
Other
- Property sync (Professonal and Enterprise only): stores a value synced from a property on an associated record. Values for a sync property are automatically updated when the selected property on the associated record is set or changed. Learn how to set up a sync property.
- File: stores up to 10 files associated with a record. Files can be uploaded by users when creating or editing a record, or visitors can upload a file via a form submission. On records, limits for files uploads are 20 MB for accounts with free tools and 50 MB for accounts with paid subscriptions. When uploaded via form, files are limited to 100MB per single file and the file's link will be available from the submitter's contact record. When creating a file property, you can choose who can view files uploaded to the 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. 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.
- 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. When inserting images, the maximum size is dependent on the amount of data in the image rather than the number of pixels. The maximum size of the property value, including images, is 64 KB. Rich text properties cannot be used in forms.