HubSpot Form

HubSpot Form shows a HubSpot form on a page, with an optional eyebrow, heading, text and image. It is mostly used on download pages.

Set it up

1. Add HubSpot Form to the page.
2. In the Content group, enter the Title and optionally an Eyebrow and Description.
3. Choose the Heading level: h1 when the form’s title is the page’s main heading, h2 when the page already has one. New blocks start with h1; older blocks where it was never set use h2.
4. In the HubSpot form group, enter the Portal ID and Form ID from HubSpot.
5. Choose the Form version that matches the form in HubSpot. See below.
6. For an ebook download, fill in the Ebook download email group. See Ebook download email.

Layout

• Without an image, the heading, text and form are centred in a narrow column.
• With an image, the content is left-aligned on the left and the image is on the right. On phones the image is shown below. Show loop adds the decorative brand loop behind the image; it has no effect without an image.

Form version

Option	When to use it
v2	Forms built with HubSpot’s legacy form editor.
New	Forms built with HubSpot’s current form editor.

A block where Form version was never set uses New. If the form stays empty on the page, the version probably does not match the form. Form region only applies to New and can usually stay empty.

No negative margin in the Section style group only affects New forms. Those are pulled slightly up and left to line up with the text, because HubSpot adds space around them. Turn it on if a form looks shifted.

Good to know

• The form loads when a visitor scrolls near it, not with the page.
• Successful submissions are reported in analytics under the Conversion category: E-book download (default), Webinar sign-up or Other form. Set it on every form that is not a download, so downloads stay countable on their own.
• Track ChatGPT Ads conversion in the Visibility & tracking group also reports it to ChatGPT Ads: E-book download and Other form as lead_created, Webinar sign-up as registration_completed. See ChatGPT Ads tracking.

Field reference

Field	Default	What it does
Eyebrow	empty	Small label above the title.
Title	empty	Heading.
Anchor	empty	ID for linking to this section, e.g. #download.
Heading level	h1 for new blocks	Whether the title is the page heading (h1) or a section heading (h2).
Description	empty	Text below the title.
Image	empty	Image next to the form.
Form version	v2 for new blocks	v2 or New, matching the HubSpot editor.
Portal ID	required	HubSpot account ID.
Form ID	required	HubSpot form ID.
Form region	empty	HubSpot data region, New only.
PDF download URL, Ebook title	empty	Sent with the form for the download email.
Background, Top Transition, Top Padding, Bottom Transition, Bottom Padding	Surface High, Large padding	Section appearance, in the Section style group.
No negative margin	off	Removes the alignment offset of New forms.
Show loop	off	Decorative loop behind the image.
Visible in region, Visible for languages	empty	Limit where the form is shown. The region is checked first.
Track ChatGPT Ads conversion	off	Reports successful submissions to ChatGPT Ads, as a lead or, for Webinar sign-up, a registration.
Conversion category	E-book download	How a successful submission is reported in analytics.