How can I migrate to the CMP v2?

We have several sources available which help you with your migration to the CMP v2.

Videos

Please note that the Admin Interface has been updated since this video was created. However, the steps that you need to take to migrate have not changed.

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

Checklist

Create a support ticket or contact your dedicated Customer Success Executive to enable the CMP v2 Admin Interface for your Configuration / Setting-ID.
Hint: To create a support ticket, in the Admin Interface of your Configuration / Setting-ID, click on the ? icon at the top right and choose Support.
Important: After this step has been completed by the support team or your personal CSE, the Admin Interface for the CMP v2 has been activated. Please note, that this does not automatically migrate your Usercentrics CMP to version 2. Further steps (outlined below) are needed to complete the migration on your website(s).
Check your implementation for custom HTML (e.g. in the Banner Message, which was called Opt-In Message in v1) and remove it. Custom HTML is not supported with CMP v2.
Adjust the styling of your CMP.
Adjust the content (e.g. Banner Message).
Exchange the Usercentrics CMP script tag. Copy & paste the CMP v2 script tag from the v2 Admin Interface and replace your CMP v1 script tag with it.
Recommendation: Test in a staging environment or similar first.
With this step of switching script tags, you should also, if applicable:
1. Adjust tags in your tag manager (new event + “once per page”). This process for CMP v2 is documented for Google Tag Manager (GTM) specifically.
  For reference only (do not use with CMP v2): The CMP v1 GTM documentation.
2. Optionally, only if you’re using them, also adjust:
  - API: Switch from using v1’s Javascript API to v2’s Browser UI API
  - Privacy Policy Embeddings: Switch from v1’s version to v2's version
  - Event Listener: Switch from v1’s events to v2's events
  - Privacy Link: If you’re using a Privacy Link (e.g. in the footer of your website) as your Privacy Trigger, this will need to be adjusted for CMP v2. You can get the HTML for the v2 Privacy Link in the v2 Admin Interface under Appearance → Layout tab → Privacy Trigger

Note: Consents will be transferred automatically if the same Setting-ID is being used in the script tag.

Some settings in the Admin Interface (e.g. the Opt-In Message / Banner Message) apply to both version 1 and version 2 of the Usercentrics CMP. An overview of the settings is available.
If you are using the same Configuration / Setting-ID for v2 and you make changes in the Admin Interface for these settings, they are directly live on your current CMP version.

Possible next step

After your migration from v1 to v2, you can make use of v2’s Preview & Publish feature with future adjustments. It’s just one of the big improvements that come with the switch from version 1 to version 2 of the Usercentrics CMP.