How to use the collected forms tool

Last updated: April 16, 2018

Available For:

Marketing: Free, Starter
Sales: N/A
Service: N/A

The collected forms tool collects submissions on your website's existing forms, making it possible to consolidate all your leads into your contacts database regardless of which form your visitors submit on your website. The tool will work on any external webpage that has the HubSpot tracking code installed. 

This article covers:

Managing your collected forms

Collected forms can be used in a HubSpot CRM Free account with HubSpot's free marketing tools. Navigate to Lead CaptureCollected Forms


Enabling or disabling collected forms

At any time, you can turn your collected forms tool on or off right from your HubSpot account.
  • In your HubSpot account, click your photo or avatar in the top right-hand corner, then click Settings

  • In the left sidebar menu, click Marketing > Collected Forms.
  • Click the toggle to the right of Collect data from website forms to enable or disable collected forms. 

Once enabled, the tool will automatically start collecting submissions on your website as soon as submissions occur.

The collected forms tool is able to identify your website's external forms based on the <form> tag in the HTML code. As soon as a visitor submits a form, HubSpot stores the submission information in a cookie on the visitor's browser. This cookie is called li_formsub. The form submission data stored in this cookie is then pushed back into HubSpot to either create a new contact or update any existing contact record with the same email address.

HubSpot will try to map form fields to the following default properties: Email, First Name, Last Name, and Phone Number. Other fields included on your forms will be created as new HubSpot properties in order to store those values.

Please note: an email address is required to create a contact, so your collected form must have an Email field in order for HubSpot to record form submissions.

When disabled, submissions will no longer be collected on your non-HubSpot forms; however, all your lead flows and HubSpot forms (Marketing Hub only) will continue to generate submissions, as these are separate tools.

Seeing information for a collected form

Click one of your collected forms to see more information. The sidebar menu that appears will display the following: 

  • URL of the most recent page where a submission was collected for this form
  • Date a submission was first collected on this form
  • The CSS selector for this form. The tool uniquely identifies each form based on the CSS selector of the form itself. By default, the form will be named by its CSS selector, but you can rename the form and find the original selector here.

To learn more about how this works, check out this article.

Forms that work with the collected forms tool

Provided your form is a static HTML form, wrapped in a HTML <form> tag and not contained inside an <iframe>, HubSpot should be able to capture the submissions.  

Some common reasons why the tool would not be able to capture submissions on forms:

  • Form is not enclosed in <form> tags
  • Form is contained inside an <iframe>
  • Form has JavaScript bound to form submit event or submit button click event. This is how the tool captures submissions and any other events, and can prevent HubSpot from knowing when submissions occur.
  • Form was introduced after the page completed loading. The tool scans the page as soon as it loads and listens to submissions on forms that were present at that point.
  • Form contains a sensitive field, such as credit card number.

Supported form builders/plugins

While HubSpot can collect submissions on most forms, there are some which cannot be used due to the reasons above. The list below shows forms that are currently supported and unsupported. If you do not see your form builder/plugin here, reach out to us and we can confirm if it will or will not work with collected forms.   

Supported Unsupported
  • Contact Form 7
  • JetPack
  • Fast Secure Contact Form
  • Contact Form
  • Gravity Forms
  • Formidable
  • Ninja Forms (< v3.0)
  • Contact Form Clean and Simple
  • Quform
  • MailChimp embeddable forms
  • Native WordPress comment forms
  • Most custom forms
  • Google Forms
  • Wufoo
  • WooCommerce
  • Easy Contact Forms
  • Disqus comments
  • Jetpack comment forms
  • JotForm
  • SumoMe
  • Ninja Popups
  • Ninja Forms (v3.0+)
  • Forms contained in an iFrame
  • Optinmonster
  • FormCraft
  • cVita
  • Typeform
  • Caldera
  • Form Maker

Was this article helpful?

Previous article:

Next article: