---
title: HubSpot connector (CMS 11)
slug: cms-12/docs/hubspot-connector-cms-11
docTags: 
createdAt: 2026-08-10T15:56:02.000Z
---

:::hint{type="info"}
**Note**

The [Optimizely Digital Experience Platform (DXP)](https://www.episerver.com/products/dxp) contains many features to support you in your daily work. Depending on how your solution is set up, some features described in this documentation may not be available.
:::

The HubSpot connector add-on automatically exports form data from your website to your HubSpot account database by mapping Optimizely form fields to HubSpot database fields. For information about other database connector add-ons, see [Marketing Automation](docId\:lw3KOQMT4bS88DycCZNow).

## Set up Optimizely forms with HubSpot

The Forms Marketing Automation Integration (MAI) connector lets you connect [Optimizely form fields](docId\:KVnsZDpxrq5wlYjBejT3W) to a HubSpot database. See also [Marketing Automation](docId\:lw3KOQMT4bS88DycCZNow).

:::hint{type="info"}
**Note**

A developer must install the Forms Marketing Automation connector and the HubSpot connector.
:::

1. In the Optimizely Content Management System (CMS) admin view, select **Config** > **Tool Settings** > **HubSpot**. The HubSpot configuration settings screen displays.

   ![HubSpot settings](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/3h2_JoRTBUXjf3NtPsgGK-20260720-145619.png "HubSpot settings")

   :::hint{type="info"}
   **Note**

   You can have multiple instances of the same connector. For example, if you have marketing teams in separate regions, you can have more than one HubSpot connector, such as *HubSpot - Europe*, *HubSpot - US*, and *HubSpot - APAC*. Click **Add Connector** to add another instance.
   :::
2. Enter the HubSpot API key associated with your HubSpot account and click **Save**.
3. [Create a form](docId\:SR3I1aAJbh0TU85e6pNQk) on a page.
4. Click **All Properties** on the form.
5. Open the **Mappings** tab.
6. Select the **Contact** database to which you map the form fields from the **MA System Database** drop-down field.

   ![Selecting the HubSpot Contact database](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/XBdw-_m7_3Ps0NyI7PLRS-20260720-145619.png "Selecting the HubSpot Contact database")
7. Click **Publish**.
8. On the form, select **Edit** from a form field's context menu.
9. Open the **Extra field mappings** tab. The database option that you selected earlier displays.
10. Enable the database option and open the associated drop-down list to see the available fields. For example, if your form has a [Text](docId\:dGqSQKV0mgM33Efyrw9v5) field that was configured to capture an email address:

    1. Edit the email text field.
    2. Select the **Extra field mappings** tab.
    3. Select **Email** from the drop-down list to map the HubSpot database field to the **Email** field on the form.

    :::hint{type="info"}
    **Note**

    You can type in the field to show fields matching your entered string. In the following image, **email** was typed to show **email**, **owneremail**, and **saleforceemail** options (and not the other fields).
    :::

    ![Mapping a HubSpot database field to a form field](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/pOZbp_P5jWGwh6JBARhGG-20260720-145619.png "Mapping a HubSpot database field to a form field")
11. Repeat steps 8 through 10 for as many fields as you want to map.
12. Click **Publish**.

To test the mapping, go to your form on a published page, fill in and submit the form, and then go to your HubSpot provider to verify that the user is added to the HubSpot database.

## Retrieve contact data

When a visitor submits the form, the data is sent to HubSpot. To see who submitted the form, go to **HubSpot** > **Email** > **Email** to open the subscriber's screen, and choose **Subscribers** > **All Subscribers**.

## Personalize the form using a block

You can personalize a form to show only to a selected group.

![video icon](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/NbeWjFsjXcbjkYW2qWTyK-20260720-145619.svg)

Video tutorial: [Personalize content with Optimizely and HubSpot](https://episerver.wistia.com/medias/4ahpgqfsce). (2:34 minutes)

For more information about creating a visitor group and displaying information based on a visitor group, see [Audiences](docId\:rodC2wlhTnWSmd-DJR2_y).

1. From the context menu on the form on the page, select **Personalize**. The **Large content area** dialog box appears.

   ![Personalize HubSpot form](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/OsTu2lhtd-LeEewmAZlpo-20260720-145619.png "Personalize HubSpot form")
2. Click **Everyone** and select a visitor group from the list. The following image shows personalizing the form to show only for people in the *VIP* visitor group.

   ![Personalize HubSpot form](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/iPKqd7BPzfc_hFQNZ3Pl4-20260720-145619.png "Personalize HubSpot form")

To create a visitor group for a HubSpot form, see [Create a visitor group for an MAI connector form](docId:0TrCDHzFBFPQnvrRj-Vka).