Find answers and general information quickly about theforms tool in HubSpot.

Learn more abouttroubleshooting HubSpot forms.

Form behavior

What field validation is on HubSpot forms?

Email addresses entered into theEmail field on a HubSpot form are immediately validated by HubSpot. Although email addresses can't always be validated with complete accuracy, HubSpot will try to verify the following:

• Formatting:the text that the user entered must look like an email address, and the top-level domain must appear in thepublic suffix list.
• Domain blocklist: the email address cannot be part of thislist of automatically blocked email domains.
• DNS lookup: the email address must have an MX record or an A record.
• Deliverability: the email address must not be globally blocked.

If the email address doesn't pass these validation rules, the formcannot be submitted. You can alsoblock specific email domains orvalidate 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 HubSpotForms API.

Can I redirect visitors to different thank you pages based on their form responses?

Users in aMarketing Hubor Content Hub Professional orEnterpriseaccount can use conditional logic to redirect visitors to a HubSpot page or external URL based on their form responses. Learn more about redirecting a form to a meeting scheduling page, HubSpot page, or external URL.

If you have aProfessional orEnterprise account, you can use workflows tosend an email after a form submission.

Can I embed a HubSpot form in an email?

No, it isn't possible to embed HubSpot forms in your emails. Forms aren't supported in emails across common email clients because of security risks. Instead, it's best practice to use the calls-to-action (CTA) tool or a link to a landing page with a form in the body of your email.

Forms and contact activity

Does HubSpot track activity before a contact converts on a form?

Yes. When a visitor lands on your site, HubSpot tracks their activity and identifies them as a unique visitor bysetting 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 willnot be able to associate previously tracked activity with the new contact.

Can I export my forms and form submission data? 

Yes, you can export aspreadsheet of your forms data to share with external stakeholders. You can also export all form submissions from a specific form or from a specific page. Learn more aboutexporting your form submissions. 

Can I set a submission limit on my form?

No, it isn't possible to set a submission limit on a form. As an alternative, you can manually keep track of theform's submissionsanddelete the form once it has reached the pre-determined number. If you haven't shared theform's standalone page, you can also consider removing the form from all HubSpot and external pages. However, any visitors with access to the form's standalone page will still be able to submit the form. 

Can I unpublish or archive a form? 

No, it isn't possible to unpublish or archive a form. If you no longer need a form, you can considerdeleting the form. If you haven't shared theform's standalone page, you can also consider removing the form from all HubSpot and external pages. However, any visitors with access to the form's standalone page will still be able to submit the form. 

How do I retrieve the embed code for my HubSpot form?

If you plan on using your form on an external page, you canretrieve the form embed code from the forms dashboard. If you're using a legacy form that has beenset as raw HTML, you can work with a developer to furthercustomize the embed code. 

To copy the embed code:

1. In your HubSpot account, navigate toMarketing >Forms. 
2. Hover over your form and clickActions. Then selectShare. 
3. In the dialog box, click theEmbed code tab and then clickCopy.

Edit and customize forms

Can I change the field validation text on my form?

No, it's not possible to edit the form field validation text (e.g., "Please complete this mandatory field.") directly in HubSpot's forms tool. Instead, you cancustomize the form's 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.

How do I integrate my custom-built form with HubSpot?

If you need additional functionality that isn't available with standard HubSpot forms, you can work with your developer to integrate your external forms with HubSpot using the HubSpotForms API.

Can I customize my form's JavaScript and HTML?

HubSpot forms are built with JavaScript, not HTML.Customizing the form's 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 HubSpotForms API.

Can I customize form submission notification emails?

Users in aProfessional orEnterprise account can use workflows to create and sendcustom internal notification emails, in addition to the default form submission notification emails.

How do I set a contact or company lifecycle stage with a form?

When a contact or company is created via a form submission, theLifecycle stage value set depends on the following:

• If you've set a default lifecycle stage in theform’s settings, the newly created record will have that lifecycle stage, regardless of other lifecycle stage settings.
• If theSet lifecycle stage when a contact or company is created setting is turnedon, contacts or companies created via form submissionswill be assigned that lifecycle stage, unlessyou've set a default lifecycle stage in theform’s settings.
• If theSet lifecycle stage when a contact or company is created setting isoff, contacts or companies created via form submissions will be set to the account's first lifecycle stage in display order, unlessyou've set a default lifecycle stage in theform’s settings.

What are the differences when adding aDefault value andPreselect value to a form field? 

When a property has a default value or preselect value, the value will be submitted unless it's manually changed by the visitor before submitting the form. Do note the following behavior:

• Default value: if thePre-populate fields with known values option is toggled on, the default value will take precedence andwill not be overwritten by any existing values. This is useful when you want topass a specific value with hidden form fields.
• Preselect value: if thePre-populate fields with known values option is toggled on, preselected valueswill be overwritten by any existing values. If you're trying topass a specific value with hidden form fields, it's important to note that pre-selected form fields can be overwritten by previously submitted form field values. 

When adding a property to your form, the option to enter a default value or preselect value depends on theproperty field types you're using: