Skip to main content

Upgrading your CMP version (v1 → v3)

Updated

The purpose of this article is to answer common questions about migrating from v1 to v3.

Version 3 of Usercentrics Consent Management Platform (CMP) brings a wide variety of optimizations and new features as well as better performance, and our team is always hard at work adding more. Get even more functionality and flexibility to build user trust and optimize your key KPIs.

The following FAQ addresses the migration from CMP v1 to CMP v3 to help your company make the change smoothly. Contact our support team or your Customer Success Manager with any questions and begin your migration to CMP v3.

Frequently Asked Questions

What benefits can I expect from migrating to CMP v3?

Version 3 of Usercentrics CMP comes with a lot of enhancements, many of them are only available in v3. Some of these include:

  • Substantially reduced file size and faster loading times.
  • Performance optimised UI.
  • WCAG 2.1 AA web accessibility certification.
  • Cross-device Consent Sharing (available in our Premium Plans).
  • Advanced Analytics Dashboard and Reporting.
  • Custom CSS.
  • A/B Testing.
  • Multi-configuration Bulk Editing (available in our Premium Plans).
  • Preview & Publish functionality.
Yes. Because TCF 2.2 was not yet available with v1, it’s only included with v3. That’s the version that can enable TCF 2.2 compliant consent.

Implementation

Are there instructions for the migration and/or the implementation of CMP v3?

To give you a quick overview of the migration process, here’s a handy checklist. Full details are in the linked documentation.

  1. Log in to your updated Admin Interface account.
    Ensure that you're on v2 of the Admin by selecting it in the upper left corner.
    Admin version selection
    You can find the v3 script2 under Implementation1. Be sure to have selected V3 Script Tag.
    Additionally, you may find detailed instructions using the link below the script tag.
    Implementation section of the Usercentrics Admin Interface
  2. Replace the v1 CMP script tag with the new v3 version.
  3. Adjust the styling of your CMP under Appearance.
  4. Adjust the content (e.g banner message) under Content.
    Optionally, also adjust:
     

Consents will be transferred automatically if the same Settings ID is being used in the script tag.

Do I have to start a new implementation when migrating to CMP v3?

To migrate to CMP v3, please replace the current Usercentrics script with the new script, which you can find in your Usercentrics Admin Interface.

If you integrate Data Processing Services using the Google Tag Manager, please adjust your tag’s existing variables and triggers: Google Tag Manager configuration for CMP v3

If you use the following, they will also need to be changed, as they differ between v1 and v3:

Nothing will change for Data Processing Services that you have integrated directly into your source code. These can still be adjusted: Direct integration of the Usercentrics CMP into your website.

Will existing stored consents from v1 be transferred to v3?

Provided that the Settings ID remains the same, previously obtained consents can be transferred over to v3. There is a script integrated in v3 that adjusts the local storage from v1 to v3.

v3 is not backwards compatible, so converting consents from v3 to v1 is not possible.

Will there be an API interface in CMP v3?

Yes. The available functions can be found in our Browser UI API documentation.

Can Usercentrics recommend a partner for the implementation of CMP v3?

Our partners TWT, DWC and E-dialog will be glad to assist you with the implementation.

User Interface and Configuration

Where can I see an example of the browser UI in action?

It’s in use right on the Usercentrics website.

What are the customisation options for v3?

The following customisations can be made directly in the Admin Interface:

  • Logo
  • Font
  • Layout (banner or wall)
  • Categories in the first layer
  • Deny button: Yes or No
  • Privacy Settings: various options
  • Privacy Trigger: various options

Check the Admin Interface for further customisation options.

Can I customise the UI in the Admin Interface?

Yes, we offer extensive customisation features for the v3 CMP which can be accessed (and previewed) in the Admin Interface.

Is Custom CSS available in CMPv3?

Custom CSS is only available for Premium plans. Please note that any CSS updates made by the customer are done at the customer’s own risk. We cannot support CSS troubleshooting.

Features

What features are currently available in v3?
  • Cross-Device consent sharing (available in our Premium Plans) & Cross-Domain consent sharing.
  • GDPR, CCPA/CPRA, VCDPA, CTDPA, UCPA, CPA, POPIA and TCF 2.2 support
  • UI customisation
  • WCAG 2.1 AA Web Accessibility Certification
  • New Analytics dashboard and A/B Testing
  • Preview & Publish functionality
  • and more
Can I preview the UI in the Admin Interface like in v1?

In the CMPv3 we have an improved version of the preview function. Our new “Preview & Publish" feature enables you to save changes made in the Usercentrics Admin Interface to a draft version before publishing them to the live version of your CMP

How will reporting work in v3?

We revamped our Analytics Dashboard, and in the CMP v3 you will be able to obtain very detailed insights into your user’s consent decisions, including how they interact with the CMPand overall opt-in rates. You will also be able to conduct A/B Testing directly in Usercentrics. Learn more about the improved Analytics.

Can I share custom Data Processing Services (DPS) via multiple setting IDs?

Yes, sharing custom DPS among multiple Settings IDs is possible with the Enterprise and Premium Plans.

Can I make batch edits in v3 for various Settings IDs?

That function is available for Enterprise and Premium customers upon request to their Customer Success Manager.

 

To learn more, we welcome you to get in touch to chat with one of our experts or schedule a demo.