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. 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 20 digits in length. After 20 digits, they'll be shown in exponential notation.
- Unformatted: removes number formatting, for example 1000000. Unformatted numbers are treated like strings, so unformatted values can have a large number of digits. However, for best results in reports, values should not exceed 38 total digits, 10 of which can be to the right of the decimal place.
- 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 workflows and segments 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 workflows or segments. 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.
- Rollup: stores a value. It calculates the property values of all records of a selected object based on the rollup type. Type options include Min, Max, Count, Sum, and Average. (e.g., the count of all associated companies create dates). Format options include Formatted, Unformatted, Currency, Percentage, and Duration. For example, you can create a rollup property to get the count of all associated companies based on their create dates.
- Score (legacy): 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 (Professional 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 files associated with a record. Files can be uploaded by users when creating or editing a record. Visitors can upload a file via a form submission. Each file property can contain up to 10 files. On records, limits for file uploads are 20 MB for accounts with free tools and 50 MB for accounts with paid subscriptions. When uploaded via a form submission, each file is limited to 100MB, 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. 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). You can specify a list of domains that should be allowed or blocked. When you enter a value, https:// will be automatically appended to the beginning. Any value that does not fit the valid URL format cannot be saved. URL property values are clickable links in the CRM (e.g., when displayed on an index page). URL properties cannot be used in forms.
- 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.