Skip to content

Set up your cookie tracking settings and consent banner

Last updated: March 12, 2025

Available with any of the following subscriptions, except where noted:

All products and plans

Super Admins and users with permission to edit website settings can customize visitor cookie tracking and consent banners to comply with global data protection laws and the General Data Protection Regulation (GDPR) and the California Consumer Privacy Act (CCPA).

A cookie consent banner allows visitors to opt in or opt out of being tracked in your HubSpot account with cookies. This feature works for all HubSpot pages as well as any external pages with your HubSpot tracking code installed.

To learn more about the most commonly asked questions about HubSpot's consent banner tools, check out the frequently asked questions.

If your account was created before November 2nd, 2022, and you don't want to opt into the current editor, you can continue using the legacy editor.

Please note: while HubSpot has cookie tracking and privacy policy settings, your legal team is the best resource to give you compliance advice for your specific business circumstances.

If your account was created before November 2nd, 2022, and you'd like to use the most up-to date option:

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Privacy & Consent.
  • Click the Cookies tab.
  • At the top, click Switch to the new design.

  • Click Next.
  • Your internal domains will appear.
    • If you need to connect external domains, click Add external domain. In the pop-up box, enter your domain. 

  • Click confirm and continue.
  • In the Published section, in the dropdown, select the domain you would like to use for each policy.

  • Click Done.

Before you get started

To set up a consent banner with the new editor, HubSpot will need to verify the website domain you're adding the banner to. To verify a domain with HubSpot, you'll either need to connect it to your HubSpot account, or add the tracking code to your external domain.

If you're a Super Admin or a user with permission to edit website settings, continue reading how to set up and edit consent banners.

Please note: if you are using a cookie-blocking extension, you may see a blank page on the Cookies tab. To resolve this, turn off the extension or use an incognito window.

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Privacy & Consent.
  • Click the Cookies tab.
  • Under Domains Connected to HubSpot, click the domain name, which will be marked as having an Inactive banner.

  • Click Default Banner to edit your default banner, or click Create consent banner to create a new banner.

Configuration

  • In the right panel, enter the following information:
    • Internal consent banner name: the name that'll display in your HubSpot account. 
    • URL Path: set a subdirectory for a more targeted banner (e.g., if the French version of your website is hosted on the /fr subdirectory, enter fr).
    • Countries: display the banner to visitors from specific countries by selecting the target countries from the dropdown menu. HubSpot uses your visitor's browser IP address to determine which country they're in.
    • To support Global Privacy Control browser signals on pages with the consent banner, toggle the the Respond to Global privacy signaling switch on. 
    • Click to expand the Advanced cookie banner settings section. In this section you can turn on either of the following options. If you do so, the banner won't display on these pages and your visitors won't have the option to consent of decline tracking through our banner. 
      • Deactivate cookies?: Toggle the switch on if you want to never allow cookie tracking for the pages or countries specified above.
      • Allow all cookies?: Toggle the switch on if you want to always allow cookie tracking for the pages or countries specified above. 
      • You can also review HubSpot's developer documentation for more information on turning off cookies, or allow your users the option to reopen the consent banner with a cookie settings button.
    • Click Next.

Notifications

Choose one of of the options to determine how you want to communicate to visitors about HubSpot tracking on your site.

  • Notification: select this option to display a notification to your visitors to show that your site uses cookies.
  • Opt-in: select this option to require users to opt-in to cookie tracking. If you select this option, you can also select the Allow opt-in by category checkbox to show your visitors the cookies that'll be put on their browser by category. Learn more about the cookies and their categories.
  • Opt-out: select this option for visitors to automatically accept all cookies, but they can opt-out via the banner. If you select this option, you can also select the Allow opt-out by category checkbox to allow visitors to opt-out of cookies by category. Learn more about the cookies and their categories. 

Learn more about consent banner types.

  • If you select Notification, you can customize the following fields:
    • Notification text: text displayed in your privacy banner.
    • Accept button text: button text visitors click to accept your privacy banner's terms.
  • If you select Opt-in or Opt-out, you can customize the following fields: 
    • Notification text: text displayed in your privacy banner.
    • Accept button text: button text visitors click to accept your privacy banner's terms.
    • Decline button text: button text visitors click to decline your privacy banner's terms.
    • Disclaimer text: text displayed when opt-in or opt-out is required.
  • If you select the Allow opt-in by category or the Allow opt-out by category checkbox, you must customize the following fields for each cookie category. To edit these fields for a specific category, click the cookie category name to expand the editing options:

 
  • Cookie settings button text: enter the text that the visitor can click in the cookie consent banner to view the cookies by category.
  • Label: for each category, enter the label you want for the category. This'll appear in the left panel and the top of the right panel in the cookie banner's dialog box.
  • Description: for each category, enter the description for the category. This will appear in the right panel in the cookie banner's dialog box.
  • Always active toggle text: for the Necessary cookies category, enter text to indicate that these cookies will be active. Because these cookies are necessary, visitors can't opt out of this individual category when they accept the terms of your consent banner.
  • Accept all button text: enter text for the button that visitors can click to accept all categories of cookies.
  • Save button text: enter text for the button that visitors can click to save their cookie preferences.
  • When you're done, click Publish to publish the banner. You can later unpublish a cookie banner so that it doesn't appear on your website by clicking to toggle the switch to the right of the banner off.

    • Learn how to customize your consent banner.

    Please note: if you're using the HubSpot ads tool to add a pixel to pages with the HubSpot tracking code, your cookie consent banner will automatically display when the pixel fires on your pages. If you require visitors to opt into cookie tracking, the pixel will not be able to place any cookies until the visitor confirms their consent.=


    • In your HubSpot account, click the settings settings icon in the top navigation bar.
    • In the left sidebar menu, navigate to Privacy & Consent.
    • Click the Cookies tab.
    • To set up a consent banner for an external domain:
      • Click Add external domain.
      • In the dialog box, enter the domain or subdomain URL. If the root domain redirects to a subdomain, add the subdomain. For example, If you're adding xyz.com but that page redirects to www.xyz.com, you must add www.xyz.com.
      • Click Add domain. HubSpot will then attempt to verify the domain based on whether the tracking code is present at the specified URL.
      • Once verified, click Create consent banner, and continue setting up your banner.

    To add a button for visitors to re-open the cookie consent banner and revoke their cookie consent to the cookies implemented or loaded by the cookie consent banner:

    • In your HubSpot account, click the settings settings icon in the top navigation bar.
    • In the left sidebar menu, navigate to Privacy & Consent.
    • Click the Cookies tab.
    • Click the domain name. 
    • Click Cookie Settings Button to expand the section. Then, click Copy to copy the code.

    • Add the code to the pages of your site that have the HubSpot tracking code, where you want the Cookie settings button to appear.

    If you want to install the code on all pages, most content management systems can install code to all pages on your site, such as a footer file that is referenced across all pages. In HubSpot, you can add the code to the footer HTML of all pages on a specific domain. It is recommended to check with your developer to determine how to do this on external sites.

    Please note: if Require opt-in is not turned on for your cookie banner, once the cookie banner is closed in a browser, you cannot re-open the banner. This is because if the banner does not require visitors to opt-in, there is no opt-in consent they'd need to revoke or update.

    If a visitor accepts your consent banner, you can track them with the cookie settings you've set up in your account. If a visitor declines your consent banner, they won't be tracked with unnecessary cookies. HubSpot forms will display and collect submissions. 

    Please note: the cookie consent banner blocks some HubSpot cookies, but there are some necessary cookies that will be dropped in the visitors browser. Opting out of cookies prevents anonymized analytics data (e.g., traffic, page views) from being associated with a specific contact record.

    The cookie consent banner also blocks cookies from HubSpot integrations, including Google Analytics and Google Tag Manager. HubSpot can only block these cookies if you use the integrations. HubSpot cannot automatically block cookies from scripts you manually place on the page.

    After contacts interact with your cookie consent banner, you can view a single contact's interaction, create a list of contacts based on their interaction, and report on interactions.

    Was this article helpful?
    This form is used for documentation feedback only. Learn how to get help with HubSpot.

    Related content