Skip to main content

Config V2 Migration Guide

This guide will help you migrate from Config V1 to Config V2.

Migrating from Config V1 to Config V2​

Step 1: Create the V2 config​

  1. Open the ConfigCat Dashboard and click on the Start migration button on top of a V1 config.
  2. Click Create V2 config to create a new config with the same settings as the V1 config.

It's important to note that the V2 config was created with the same settings as the V1 config and the V1 config is still accessible and unchanged.

Step 2: Update the ConfigCat SDK​

In your application, update the ConfigCat SDK to the latest version. Old versions of the SDK will not be able to access the new config. Make sure you update every application that uses the migrated config.

Step 3: Update the ConfigCat SDK Key​

In your application, update the ConfigCat SDK Key to the one that belongs to the V2 config. The new key can be found on the ConfigCat Dashboard on the V2 config's page.

Step 4: Clean up​

After you've updated all your applications to use the V2 config, you can delete the V1 config. You can check the config JSON download trends page to see if there are any applications that still access the V1 config.