The xDB to CDP migration tool
To use the migration tool, you need to download and import the xDB to CDP migration
package to your Sitecore Connect instance. The package:
-
Extracts the data from xDB.
-
Transforms the data to a format that can be interpreted by CDP.
-
Transfers the data to CDP.
The migration tool consists of two connections and four recipes.
Connections
-
Sitecore XP Connection - responsible for establishing connection to the xDB database.
-
Sitecore CDP Connection - responsible for establishing connection to Sitecore CDP.

Recipes
The xDB to CDP Migration tool contains 4 recipes:
-
[XCM] REC001 | Processing Recipe Trigger
- responsible for repeatedly triggering the[XCM] REC002 | Load And Transform Contacts From xDB
recipe until all the contacts are processed.ImportantOnly built-in facets are mapped to guest data extensions in CDP. If you have custom facets, you need to configure the mappings before running the triggering recipe.
-
[XCM] REC002 | Load And Transform Contacts From xDB
- responsible for extracting and transforming the data from xDB. -
[XCM] REC003 | Upload Contacts to CDP
- responsible for pushing the data to CDP. -
[XCM] REC004 | Migrate Contacts By ID
- a standalone recipe responsible for migrating specific contacts.