Find answers and general information quickly about the forms tool in HubSpot.
Form behavior
Forms and contact activity
Edit and customize forms
Form submissions
When you find that there are issues with your HubSpot form, it could stem from the HubSpot form itself, or the page that the form is embedded on. To find out where the issue comes from, you can troubleshoot your HubSpot form by testing the form itself.
To do this, share a link to a standalone page with the form. This page does not have any elements that adversely affects the form. Once you have the Share link, access the page, make a test submission and check the test submission.
If the submission is successful and is not affected by the error, the issue is likely related to the page where it was embedded on. In this case, check with your developer on the possible elements on the page that could've affected the submissions (e.g., scripts, stylesheets).
If the submission was also affected by the error, get further help from HubSpot.
Email addresses entered into the Email field on a HubSpot form are immediately validated by HubSpot. If the email address is not valid (does not exist, is misspelled, etc.), the form cannot be submitted. You can also block specific email domains or validate phone numbers in form submissions.
If you want to build a form with custom validation rules, you can work with your developer to integrate your custom form with HubSpot using the HubSpot Forms API.
If some fields are not being displayed on your form when you add it to a page, it is likely that the form has progressive profiling and HubSpot remembers you from previous interactions or testing. Progressive fields are hidden if the visitor has previously filled in the field or if the contact already has a value for the property.
No, it is not possible to embed HubSpot forms in your emails. Forms are not supported in emails across common email clients due to security risks. Instead, it is best practice to place a call-to-action or a link to landing page with a form in the body of your email.
Yes. When a visitor lands on your site, HubSpot tracks their activity and identifies them as a unique visitor by setting tracking cookies in their browser. Once the visitor submits a form, HubSpot will try to associate the new contact record with any previously tracked activity.
If a visitor clears their cookies before submitting a form on your site, HubSpot will not be able to associate previously tracked activity with the new contact.
If a contact has submitted a form but their Number of pageviews property value is '0', it's likely because cookies were blocked when the contact submitted the form. This could be due to several reasons:
The HubSpot tracking code must also be installed on your site and firing correctly in order to track page views.
HubSpot uses multiple third-party databases to try to match a visitor's IP address to their geographic location. There are two reasons why a contact's IP Country, IP State/Region, or IP City may be blank:
If a property is not available as a form field, it may be because it is not set up to be shown in forms.
No. Only contact properties can be added as a field on a HubSpot form. If you have a Professional or Enterprise account, you can use a workflow to copy contact to company properties.
No. When cookie tracking is disabled on a form, there's no tracking cookie for the form fields to reference to identify a contact and progressive profiling will not work.
You cannot edit the form field validation text (e.g., "Please complete this mandatory field.") directly in HubSpot's forms tool. Instead, you can customize the form embed code or write a custom script to load on the page and replace the default validation message. Both methods require the help of a developer who knows how to work with JavaScript, and are not supported by HubSpot Support.
If you need additional functionality that is not available with standard HubSpot forms, you can work with your developer to integrate your external forms with HubSpot using the HubSpot Forms API.
HubSpot forms are built with JavaScript, not HTML. Customizing the form embed code requires the help of a developer who knows how to work with JavaScript. Any customization that goes beyond adjusting the form embed code must be done with a custom-built form and the HubSpot Forms API.
If you have a Professional or Enterprise account, you can use workflows to create and send custom internal notification emails in addition to the default form submission notification emails.
When a contact fills out a form, their lifecycle stage will be set to Lead by default. You can set a different lifecycle stage in one of two ways:
No, it is not possible to send visitors to different thank you pages based on how they respond to questions on your form, unless you build a custom form and integrate it with HubSpot using the HubSpot Forms API.
If you have a Professional or Enterprise account, you can use workflows to send different follow-up emails based on how contacts filled out a form.
Form submissions are recorded any time the Submit button on a form is clicked. If a form is submitted multiple times with the same email address, only one contact will be created, but each form submission will still be recorded. If a contact is deleted from HubSpot, their form submission will still appear, but they will no longer show up in a list filtered by the form's submissions.
For a form submission to create a contact record in HubSpot, the default Email field must be used on your form. If not, you must allow form submissions without email addresses to create contacts.
If the form submission uses an email address already associated with a contact record, or if the submission is done in a browser with tracking cookies tied to an existing contact record, it will update the existing contact record and not create a new one. Learn more about how HubSpot deduplicates contacts and how to recreate contacts overwritten by form submissions.
The HubSpot forms tool is equipped with virus detection that prevents suspicious files from being uploaded in form submissions. If a visitor submits a form with a file and a virus is detected, the message [File name] removed from submission will appear in the submission details
If you don't allow form submissions without email addresses to create contacts, there are two reasons why you may see 'No contact record' in your form submission:
If you see a 'No record' conversion page in your form submission, this means HubSpot wasn't able to determine where the submission occurred. This could be due to two reasons: