Last updated: December 17, 2025
Available with any of the following subscriptions, except where noted:
HubSpot flags property values as invalid when they don’t meet the property’s requirements, such as incompatible types, missing enumeration options, or unmet validation rules. Learn how to fix invalid values for common invalid property value scenarios.
Review invalid property value examples
The following is a non-exhaustive list of common scenarios that result in an invalid property value:
- Property field type change: a value was entered into the property, but the property is later changed to another type, making the original value invalid (e.g.Single-line text to a Date picker type).
- Validation rule: a value was entered into the property that doesn't follow the configured validation rule such as a character count restriction or regular expression rule (e.g., a special character value was added to a property using the Don't allow symbols or special characters rule).
- Import enumeration property: enumeration property values (e.g., Dropdown select) within an import spreadsheet don't match the existing options in your account (e.g., sheet contains Testing mapped to the Industry company property).
- Unique value: a non-unique value was entered into a property that requires unique values (e.g., an email was entered on a contact, but the email already exists on a different one).
- Forms API: the contact has an invalid property value set via the forms API. The Forms API allows any value to be passed to a property, even the value is invalid.
- Missing enumeration property option: the enumeration property option is missing or was changed via the properties API (e.g., a user performed a PATCH call on a dropdown select property and the previous options were changed or removed).
Fix invalid property values
Resolve invalid property values in scenarios experienced above by:
- Configuring automatic validation rules to remove whitespace and disallowed characters. This mitigates a property value entering an invalid state.
- Manually editing the individual value so that it's compatible with the property field type, validation rule, or unique value. (e.g. update the text value to a date value, remove any special characters, use a different email address).
- Fix the error within the import wizard.
- Bulk updating the invalid values for the affected records. Learn how to do this using an import, on an index page, or using the Edit record action in workflows.
- Adding the invalid value(s) as options to the enumeration property.
- Reviewing the forms API configuration to ensure desired values can be passed successfully (e.g., adding the invalid values to the multiple checkbox property in the CRM).
