Getting your page ready

Getting your page ready...

0%

Thanks for visiting PipelineSync.

Home Solutions Pricing Integrations Resources About Book a free consultation

allentrinidad@pipelinesync.net

MARKETING • 9 MIN

HubSpot Forms: Setup, Limits and Best Practices

For teams capturing leads with HubSpot forms: what each plan includes, which editor to use, how fields map to records, how to keep spam out and consent clean, and how to measure conversion.

By the PipelineSync team Updated

PipelineSync field guide

What are HubSpot forms?

HubSpot forms collect visitor details and write them to CRM records, usually contacts, matched by email address. You can put them on HubSpot pages, embed them on any site, or share them as a standalone page. Forms are available on every HubSpot plan, including free; paid plans add steps, conditional logic, domain blocking and more automation.

This guide follows HubSpot's documentation as of October 2026. Plan each form's fields, consent and follow-up first with our free form field plan.

What does each HubSpot plan include for forms?

Every plan can build forms, embed them and send a follow-up email. When we checked in October 2026, form steps needed any Starter plan, with up to 20 steps per form, and the progress bar needed Marketing Hub Starter. Conditional logic needed Marketing Hub or Content Hub Professional, and email domain blocking needed Marketing Hub or Content Hub Starter.

FeaturePlan needed (Oct 2026)
Forms, embedding, reCAPTCHA, consent optionsAll plans, including free
Form steps (up to 20)Starter, Professional or Enterprise
Progress barMarketing Hub Starter or higher
Block email domainsMarketing Hub or Content Hub Starter or higher
Conditional logicMarketing Hub or Content Hub Professional or Enterprise
Progressive and dependent fields (legacy editor only)Marketing Hub, Service Hub or Content Hub Professional or Enterprise

HubSpot's own pages disagree on the number of conditional logic rules per form, so check the limit in your account before you plan a large form around it.

Should you use the new or the legacy form editor?

Use the new editor for new forms. HubSpot now labels the old editor legacy and recommends the updated one. Validation rules on properties are only enforced on forms built in the new editor, and form shortening and global form events are new-editor features. The legacy editor still holds progressive fields, dependent fields and raw HTML forms.

  • Form shortening hides fields HubSpot can fill by enrichment; enriched values are marked with an AI icon, and HubSpot notes it may need extra compliance steps.
  • Unsupported properties: some property types, such as calculation, rollup and rich text, can't be used as form fields.
  • No migration tool was documented when we checked, so moving a legacy form means rebuilding it.

How do form fields map to contacts and companies?

Each field writes to the property it's connected to, which decides the object, usually contact or company. HubSpot deduplicates contacts by email. With the setting to create new contacts for unknown emails turned off, HubSpot may update a contact from the browser cookie instead, which can overwrite records. A company domain field updates or creates the matching company.

  1. 01 SubmitFields and consent
  2. 02 Spam checkDomains, CAPTCHA, IPs
  3. 03 MatchEmail or cookie
  4. 04 Update recordContact, company
  5. 05 Follow-upEmail, workflow, alert
The path of a typical submission. Each step is described above and below.
  • Hidden fields pass values such as lead source; a required field can't be hidden, and pre-population can overwrite the hidden value.
  • Query strings can pre-fill fields on all plans; checkbox values must be true or false and dates YYYY-MM-DD.
  • Ask only what you use. Each field should feed routing, scoring or follow-up; the field plan template records why each one exists.

How do you keep spam out and consent clean?

Add every site you embed on to the form's allowed domains, or HubSpot marks those submissions as spam. Turn on reCAPTCHA, available on all plans, unless an integration submits through the API, since CAPTCHA blocks API submissions. Block free or disposable email domains if you need business emails, and choose a consent option that matches how you'll email people.

  • Spam submissions don't create records, trigger automation or count in analytics, and are deleted 90 days after submission.
  • Consent options: implicit consent with communication checkboxes, separate consents, or legitimate interest with a notice. The communication checkbox can't be pre-selected.

Forms filling HubSpot with junk or duplicates? Bring one to a free 30-minute call and we will review its fields, spam settings and matching.

What happens after someone submits?

Show a thank-you message or redirect to a page, URL, meeting link or payment link. Send notifications to the right people, and use the form's simple workflows for follow-up: free accounts get one follow-up email, Marketing Hub Starter up to 10 actions, and Marketing Hub Professional multiple workflows. Follow-up emails only reach marketing contacts.

For routing, lead status and anything conditional, use a full workflow triggered by the form submission. Our HubSpot workflows guide covers triggers and testing.

How do you measure form performance?

Each form's performance view shows views, submissions and conversion rate, which HubSpot calculates as submissions divided by views, plus submissions by source and, for multi-step forms, step completion. Submissions through the forms API don't count views. Review forms monthly, remove fields that lower completion without feeding routing or scoring, and check the spam tab.

HubSpot forms checklist

✓
New editor used
✓
Fields mapped to properties
✓
Every field has a reason
✓
Hidden fields for source
✓
Allowed domains added
✓
CAPTCHA decided
✓
Consent option chosen
✓
Notifications set
✓
Test submission checked
✓
Monthly conversion review

Key takeaway: A form is a data contract. Build it in the new editor, map every field to a property you use, add allowed domains and CAPTCHA, choose consent deliberately, and test a submission before it goes live.

Frequently asked questions

Are HubSpot forms free?

Yes. When we checked HubSpot's documentation in October 2026, forms were available on all products and plans, including free. Paid plans add features: form steps need a Starter plan, conditional logic needs Marketing Hub or Content Hub Professional, and blocking email domains needs Marketing Hub or Content Hub Starter.

Can HubSpot forms use progressive fields?

Only in the legacy editor. HubSpot's documentation says progressive fields are not supported in the updated form editor, need Marketing Hub, Service Hub or Content Hub Professional or Enterprise, and can't be used while the setting that always creates contacts for new email addresses is on. The new editor offers form shortening instead.

Why are my HubSpot form submissions marked as spam?

A common cause is embedding the form on a domain that isn't in the form's allowed domains; HubSpot marks those submissions as spam. Other causes are excluded IP addresses and referrers and bot detection. Spam submissions don't create records or trigger automation, and HubSpot deletes them 90 days after submission.

Can I submit to a HubSpot form through the API if CAPTCHA is on?

No. HubSpot says that when CAPTCHA is turned on in a form, submissions from the Submit data for a form API and other form integrations will not be accepted. Use a form without CAPTCHA for server-side submissions, and protect it with other checks such as email domain blocking.

How does HubSpot calculate form conversion rate?

HubSpot defines a form's conversion rate as the total number of submissions divided by the total number of views. Submissions made through the forms API don't create views, so API-fed forms show submissions without a meaningful conversion rate. Compare forms on the same page type for a fair picture.

Sources

HubSpot documentation behind the feature and tier notes above, checked October 2026. HubSpot changes features and tiers often, so check your own portal too.