What we do
Tools
Industries
Department
How we workLet's talk →
Home/HubSpot/HubSpot Forms
HubSpot

HubSpot Forms: How to Build a Form, Embed It, and Make Sure Leads Land

A HubSpot form creates or updates a contact every time someone submits it, matched on email address. You can embed it on any website, share it as a standalone page, or drop it onto a HubSpot landing page. The building is the easy part. Where the lead goes next is what needs thought.

Making a HubSpot form

Create it from the Forms tool, choose embedded, standalone page or pop-up, and add fields from your contact properties.

Marketing Forms Create form

Embed it on any site by pasting the embed code HubSpot gives you after publishing. It loads a script from HubSpot's hsforms domain, which is why "hsforms" shows up in your page source.

Keep an email field. Submissions without one don't create a contact.

Setting up a form so the lead goes somewhere useful

  1. 1

    Ask for less than you think

    Email, name and one qualifying question usually beats a long form. Every extra field costs you some submissions, so keep only the ones a person or a workflow will actually use.

  2. 2

    Add hidden fields for what the visitor shouldn't have to type

    A hidden field can stamp every submission with a value, such as the campaign, the product the page is about or the region. That value is what workflows and reports sort leads by later.

    Watch for: the property type. A hidden field only sets a value cleanly when it matches the property's format, such as a dropdown option exactly as spelled.

  3. 3

    Set what happens after submit

    Show a thank-you message or redirect to a page, choose who gets a notification email, and decide whether a follow-up email goes to the contact. All of that is in the form's own options.

  4. 4

    Hand the lead off with a workflow

    Assigning an owner, setting lifecycle stage and creating a task happen in a workflow triggered by the form submission, not in the form itself. Our workflows page has recipes for this.

  5. 5

    Submit it yourself before it goes live

    Use a test email address and check the contact record: the fields filled in, the hidden values, the owner and the notification. Then delete the test contact.

Form submitted, but nothing seemed to happen

No contact was created

How you'll know: The submission shows in the form's submissions list, but there's no matching contact.

Fix: The form has no email field, or the email was blocked. Add an email field, and check whether you block free email domains in the form's settings.

One person, two contacts

How you'll know: A customer filled in the form with a personal email, and now has a second record beside the one sales works.

Fix: HubSpot matches form submissions on email address, so a different address means a new contact. Merge the two, and ask for a work email on forms where that matters.

Your site's own form is creating junk contacts

How you'll know: Contacts appear from a contact form you never built in HubSpot, with half the fields missing.

Fix: That's non-HubSpot form capture, which collects HTML forms on pages running the HubSpot tracking code. Turn it off, or exclude that form, from the non-HubSpot forms settings in the Forms tool.

The form doesn't show on the page

How you'll know: The space where the form should be is empty.

Fix: A cookie banner, ad blocker or content security policy may be blocking the hsforms script. Check the browser console, and allow HubSpot's form domains if your site restricts scripts.

HubSpot landing pages, in brief

Landing pages are built in the same drag-and-drop editor as the rest of HubSpot's content tools, from templates, with your form dropped in as a module. HubSpot can also host a full website through Content Hub, the product that used to be called CMS Hub, using the same editor and templates.

If you need the same block, such as a footer offer or a phone number, on many pages, build it once as a global module and place it everywhere. Change it once and every page updates. That saves a lot of clicking later.

Where forms stop: leads from elsewhere, and routing on facts HubSpot lacks

Leads from forms HubSpot doesn't own. HubSpot can't capture Google Forms, which run on Google's own pages, and there's no first-party connector for them. The same goes for many booking tools, quote calculators on other sites, and forms embedded in iframes. The clean fix is to post those submissions through HubSpot's Forms API, so each one arrives as a real form submission with its source attached and triggers the same workflows.

Routing that depends on data outside HubSpot. Workflows can branch on property values and rotate leads across a team. They can't check who has capacity this week in your scheduling tool, whether the company is already a customer in your billing system, or which territory a ZIP code belongs to in a list kept elsewhere. That lookup has to happen before the owner is set.

Those two jobs are what n-frames builds around HubSpot forms: one path in for every lead, wherever it was filled in, and routing that checks the facts held in your other systems before a rep gets it.

Questions people ask

Does HubSpot have an API for forms?

Yes. The Forms API can create and read forms, and its submissions endpoint lets another system submit data to a HubSpot form, so the submission is recorded and triggers workflows like any other. That endpoint is how most custom form integrations work.

Can I connect a Google Form to HubSpot?

Not natively. HubSpot doesn't ship a first-party Google Forms connector, and non-HubSpot form capture can't see Google Forms because they live on Google's pages. The options are a third-party app (several are listed in HubSpot's App Marketplace), Zapier, or a direct integration that posts each response to a HubSpot form through the Forms API.

Can HubSpot route a new lead to a specific rep automatically?

Yes, through a workflow triggered by the form. It can rotate leads across a set of reps or branch on property values like region or product. Rules that depend on rep capacity or data held outside HubSpot need that data brought in first.

Why did my HubSpot form submission not create a contact?

Usually because the form has no email field, or the email address was blocked by the form's settings. The submission is still stored on the form, but without an email HubSpot has nothing to match a contact on.

Does HubSpot have a drag-and-drop landing page builder?

Yes. You choose a template, then edit layout, images, copy and forms visually, with no code needed to publish a standard campaign page.

Can I build a full website in HubSpot, or just landing pages?

Both. Landing pages and full websites use the same editor and templates. A full site with blog, website pages and themes comes with Content Hub.

Let's talk

Tell us the one thing your team does manually that eats up time. We read every message and reply within a day.