Skip to main content Skip to footer

HubSpot Developer Changelog

Automatic migration from Cookie Consent Banner v1 to v2

Starting May 11, 2026, HubSpot will resume the automatic migration of accounts from the legacy Cookie Consent Banner (v1) to the current version (v2). This process was previously announced and later paused to allow more time for manual adoption. This update ensures all accounts use a banner that meets modern accessibility standards and supports the latest privacy features. While the migration happens automatically on this date, you can manually opt-in ahead of time to test the new version within your account.

What's changing?

The v2 Cookie Consent Banner features an updated design, groups banners by domain, and includes features like support for Global Privacy Control (GPC), opt-out banner types, and expanded customization options.


The customization UI for the new cookie consent banner, showing positioning, background settings, and spacing.

This migration changes the HTML structure of the cookie banner. If you use custom CSS or JavaScript to modify your banner's appearance or behavior, you may need to update your code to remain compatible with the v2 structure.

Key considerations for developers:

  • Updated HTML: You may want to review any CSS and JavaScript that previously targeted the cookie banner HTML because the HTML is changing.
  • Refined styling: The v2 banner supports more customization options within the HubSpot UI, which may eliminate the need for some of your existing custom CSS. We encourage you to rely on the built-in customization options over custom CSS whenever possible to simplify future upgrades if privacy regulations change.
  • Manual Testing: You can opt into the v2 migration manually in your banner settings to verify that your site's styling and scripts continue to function as expected before the automatic update.

When is it happening?

This change goes into effect on May 11, 2026.

Questions or comments? Join us in the developer forums.