How to Create a Web Form in HubSpot You Can Publish and Test
To create a web form in HubSpot, open the Forms tool, build the form, set how submissions are stored and routed, and then publish it on a page or landing page. After that, submit a test entry to make sure the form works the way you expect. If the test contact lands in HubSpot with the right properties and the right follow-up, you’re done.
Before you start in HubSpot
Make sure you have access to the Forms tool in your HubSpot account and know what the form needs to do before you start building it. It also helps to know where the form will live, because that affects how you style it later.
Have these decisions ready:
- what information you need from the visitor
- which fields should be required
- which contact properties the form should update
- who should get notified when the form is submitted
- whether the form should show a thank-you message, send visitors to a thank-you page, or trigger an automated follow-up email
Create the form and add the fields you need
- Open HubSpot and go to the Forms tool. Use the Forms tool in your account to start a new form.
- Create a new form and choose the form type that fits your use case. Pick the web form option if you want to place the form on a page or landing page. Set the basic details at this stage, such as the form name, and any other setup options HubSpot shows in your account.
- Add the fields you want visitors to complete. In the form editor, add the fields in the order you want them to appear. A short form usually works best, so start with the basics such as name and email, then add only the extra questions you really need.
- Arrange the fields in a logical order. Put the fields in the sequence a visitor will understand most easily. Basic contact details usually go first, followed by any custom questions or qualifying fields.
- Mark the fields that must be completed. Set the fields your team cannot do without as required. Keep the required list as short as you can so the form stays easy to finish.
Set the options that make the form work for your team
After the fields are in place, check how HubSpot will store and route the submission. This is where you make sure the form collects usable data instead of just looking finished.
- Map each field to the correct contact property. Confirm that standard fields such as first name, last name, and email are tied to the right contact properties. For custom questions, map them to the matching custom property if one exists, or create the property if your HubSpot setup needs that first.
- Review required fields and validation rules. Make sure fields that need a specific format keep that validation in place, such as email fields. That helps prevent bad submissions from getting through.
- Set notifications for the right people. Choose who should be notified when someone submits the form. Depending on how your account is organized, that could be one person, a team, or a shared inbox.
- Choose the follow-up behavior. Decide what happens after submission. Common options are a thank-you message, a thank-you page, or an automated follow-up email. Pick one clear path so visitors know the form went through.
- Check any consent or subscription settings. If your form collects consent or subscription preferences, confirm that the labels and options match how you plan to use the data. This matters if the form feeds marketing follow-up or contact management.
Style, publish, and test the form
- Open the page or landing page where you want the form to appear. Insert the form in the page editor or landing page editor. If HubSpot gives you display or style controls for the form, set them before you publish so the live version matches the page.
- Style the form so it fits the page. Adjust the labels, button text, spacing, and any theme-related settings available in your editor. Keep the styling consistent with the page around it so the form looks like part of the page, not something added at the last minute.
- Publish the page or landing page. Save and publish the page with the form embedded so it becomes visible to visitors.
- Submit a test entry. Fill out the form yourself using a test contact if your team uses one, or a clearly identifiable test email address if that is your process. Submit the form and watch for the expected confirmation message or redirect.
- Verify the submission landed where it should. Check that the contact appears in HubSpot with the right property values, that the notification went to the expected inbox or person, and that any follow-up action fired the way you set it up. If the contact shows up with the wrong data or nothing appears at all, stop and correct the form before you share it more widely.
When that last step is complete, you should see the live page displaying the form, the test submission completing without errors, and the new contact or submission data appearing in the place you expected.
Common mistakes when creating a HubSpot form
The most common problems are usually setup misses rather than technical issues.
- forgetting to mark a key field as required, which lets incomplete submissions through
- mapping a custom field to the wrong contact property, which sends data to the wrong place
- setting the wrong notification recipient, so the team never sees the submission
- choosing the wrong follow-up behavior, such as a redirect when you expected a thank-you message
- publishing the form without testing it first on the live page
If the form doesn’t behave the way you expected, check the field mapping and follow-up settings before changing the design. Those are the places where most setup errors show up.