Features

• feat: store language code of the consent in the cookie by @OndraM in #761

Bug fixes

• fix: service reject issue & setCookieData() method deletes lastConsentTimestamp field by @peaemaye in #701
• fix: eraseCookies domain bug and expand tests by @imnasnainaec in #719

Documentation

• docs update setCookieData examples with correct function by @alanbiju79 in #686
• docs: add missing bar 'top' position option by @OndraM in #758
• docs: Add example for Google Tag Manager's consent mode by @silenzium in #751
• docs: update docs to match code and fix a few typos by @imnasnainaec in #716

New Contributors

• @alanbiju79 made their first contribution in #686
• @peaemaye made their first contribution in #701
• @silenzium made their first contribution in #751
• @imnasnainaec made their first contribution in #716

Full Changelog: v3.0.1...v3.1.0

Bug fixes

• fix: unhandled exception when category is unknown by @Idrinth in #663
• fix: default enabled categories reset on preferences modal close by @orestbida in b91b9c4

Documentation

• docs: fix broken GitHub links by @lneugebauer in #625

New Contributors

• @lneugebauer made their first contribution in #625
• @Idrinth made their first contribution in #663

Full Changelog: v3.0.0...v3.0.1

First stable v3 release! 🎉

Demo

You can check out v3 on the playground.

Main features

• more granular control over scripts, thanks to services
• better language/translation handling (allow the use of external .json files)
• more intuitive and clearer configuration parameters
• easier integration with various frameworks thanks to the ESM format (check out some demos on Stackblitz)
• many new customization options (button/modal layouts)
• multiple ways to handle your scripts, using either script-tags, callbacks or events
• and much more ...

Upgrade guide from v2 to v3? ❌

There are way too many changes compared to v2; the configuration, api, custom attributes ... everything is different, although the end result is essentially the same. I personally find it faster to just start from scratch rather than trying to adapt the previous configuration.

Should you upgrade?

YES. Although v2 will still receive some maintenance updates, it will eventually be sunset.

Last but not least

A huge thanks to everyone who contributed!

Features

• Improved language autodetection process 1ec2561 (ref. #560) by @Diewy
• Added new <service>.cookies option to easily erase cookies 5260688 3655a1b
• Improved focus handling (a11y) d8d7325 f318393

Bug Fixes

• Fixed default enabled categories ignored when mode='opt-in' 8ad2d1d baf6380 (ref. #538) by @orestbida

Documentation

• Updated code examples bf941a2 0e9c87b
• Updated UI and Customization page 611affb
• Fixed broken/outdated links 56865ae 868c275
• Added notice about Google Ad related products 85f5808

Misc

• Updated playground f4b244e 8d18429
• Updated demo examples 495df15
• Updated all dependencies to latest version 0738397

New Contributors

• @Diewy made their first contribution in #561

Full Changelog: v3.0.0-rc.16...v3.0.0-rc.17

Bug Fixes

• Fix a11y issue caused by missing aria-level attribute ecc9d6d (ref. #544)
• Fix .updateScripts() method doesn't work when mode is set to 'opt-out' a2b9fb8 (ref. #556)

Features

• Add .validConsent() method to easily check if consent is valid or not 7beb89b

Full Changelog: v2.9.1...v2.9.2

Breaking Changes

• Change the default button order: accept button now precedes the reject button (previously reversed) cb9e3b8 (ref. #534)

Bug Fixes

• Fix cookie table header doesn't span full width 9b882b8 (ref. #543) by @orestbida
• Fix equalWeightButtons does not default to true 6596054 (ref. #541)
• Fix preferences modal bar layout is broken if button order is flipped bb1a160 (ref. #539)
• Fix yarn add issue caused by npx only-allow pnpm preinstall script fa01925 (ref. #548)

Docs

• Indicate which preferences modal layouts support the serviceCounterLabel by @MoritzLost in #535

New Contributors

• @MoritzLost made their first contribution in #535

Full Changelog: v3.0.0-rc.15...v3.0.0-rc.16

Enhancements

• Clean up extraneous attributes to pass HTML validation. by @EreMaijala in #529

New Contributors

• @EreMaijala made their first contribution in #529

Full Changelog: v3.0.0-rc.14...v3.0.0-rc.15

Bug Fixes

• Fix duplicate ids in the th tags c2623fb (ref. #483)
• Fix error when a script tag with invalid category is found 3062170 (ref. #506)
• Fix focus trap stops working after calling .setLanguage() 3d54c53
• Fix css icon inconsistencies across different browsers: use svg icons f7fa35a 383a7a1

Features

• Automatically discard unsaved preferences when preferencesModal is closed a51dd88 (ref. #481)
• Add cookieTable.caption for better a11y 35b3457 a306cb3 (ref. #485)
• Allow custom z-index via --cc-z-index 91e1877 (ref. #501)
• Allow custom type on external script tags via the data-type attribute by @orestbida in #514
• Disable transitions if prefers-reduced-motion is enabled 8a34f86
• Add support for Safari 11.3+ (previously only 14+) 605ae6f 8c01126 (ref. #524)

Docs

• Fix typo in callbacks-events.md by @frusznyak in #484

Other

• Fix typo in playground de.json by @ndresx in #511
• Major playground update + update dependencies

New Contributors

• @frusznyak made their first contribution in #484
• @ndresx made their first contribution in #511

Full Changelog: v3.0.0-rc.13...v3.0.0-rc.14

Bug Fixes

• Fix wrong toggle states after opening and closing the settings modal by @orestbida in 952b5f5 (ref. #516)

Misc

• Code refactoring f185b60
• Update Readme.md: add mention about ccpa by @trymeouteh in #509
• Update dev. dependencies e50e3f7

New Contributors

• @trymeouteh made their first contribution in #509

Full Changelog: v2.9.0...v2.9.1

New Features

• Add new CSS variables by @aforcada in #482
• Allow custom script type via the data-type attribute 0b1d14a (ref. #487)
• Add settings_modal.cookie_table_caption option for better a11y bdfe84e e1bada3 (ref. #485)
• Allow custom z-index value via the --cc-z-index css variable 9707cce
• Allow data-cc attributes on all HTML elements e5ab6a0 (ref. #502)
• Disable transitions if prefers-reduced-motion is enabled fbfd628
• Discard unsaved settings inside settings_modal 4ef841d (ref. #481)

Bug Fixes

• Fix focus restoration when modals are hidden by @orestbida 004f6a3 (ref. #475)

Misc

• Small ui tweaks: slightly reduce padding ff0c83c 1296a6b
• Fix Readme.md example: hide_from_bots is true by default rather than false by @MaximumP in #448
• Remove old IE8 specific css rules c350c9e
• Update all dependencies 13072d4
• Code refactoring/cleanup

New Contributors

• @MaximumP made their first contribution in #448

Full Changelog: v2.8.9...v2.9.0