# xDB Data Migration Tool > XP documentation for developers, in English, version 2.1. - Product: XP - Audience: Developers - Language: English - Version: 2.1 - Status: Previous version - Canonical URL: https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool ## xDB Data Migration Tool - [xDB Data Migration Tool](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/xdb-data-migration-tool.md): Introduction to customizing and extending the xDB Data Migration Tool with commerce data or custom data. - [Performance tips](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/performance-tips.md): Guide to optimizing the performance of data migration from Sitecore 8.2 to later versions of Sitecore. ### Standard mappings - [Standard mappings](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/standard-mappings.md): Introduction to the standard data mappings from Sitecore 8.x to Sitecore 9 in xDB Data Migration Tool. - [Contacts](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/contacts.md): Overview of the contact data facets and identifiers in xDB Data Migration Tool. - [Addresses facet](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/addresses-facet.md): Guide to the Addresses facet and its properties in xDB Data Migration Tool. - [Classification facet](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/classification-facet.md): Introduction to the contact classification facet in xDB Data Migration Tool. - [Communication profile facet](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/communication-profile-facet.md): Overview of the contact communication profile facet in xDB Data Migration Tool. - [Contact lists facet](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/contact-lists-facet.md): Guide to the contact lists facet and its properties in xDB Data Migration Tool. - [Email addresses facet](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/email-addresses-facet.md): Guide to the email addresses facet and its properties in xDB Data Migration Tool. - [Personal information facet](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/personal-information-facet.md): Guide to the personal information facet in xDB Data Migration Tool. - [Phone numbers facet](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/phone-numbers-facet.md): Guide to the phone numbers facet and its properties in Sitecore Data Exchange Framework. - [Test combinations facet](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/test-combinations-facet.md): Guide to the test combinations facet in xDB Data Migration Tool. - [Contact identifier](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/contact-identifier.md): Overview of the contact identifier in xDB Data Migration Tool. - [Interactions](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/interactions.md): Overview of the interaction data that xDB Data Migration Tool maps from Sitecore 8.x to Sitecore 9. - [IP info facet](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/ip-info-facet.md): Guide to how information about the location of a visitor are mapped from Sitecore 8.x to 9 in xDB Migration Tool. - [Legacy xDB facet](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/legacy-xdb-facet.md): Guide to how interaction IDs are mapped from Sitecore 8.x to 9 in xDB Data Migration Tool. - [Profile scores facet](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/profile-scores-facet.md): Guide to how profile scores are mapped from Sitecore 8.x to 9 in xDB Migration Tool. - [Web visit facet](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/web-visit-facet.md): Guide to how information about web visits are mapped from Sitecore 8.x to 9 in xDB Migration Tool. - [Interaction properties](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/interaction-properties.md): Guide to how interaction properties are mapped from Sitecore 8.x to 9 in xDB Migration Tool. - [Page view events](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/page-view-events.md): Guide to how page view events are mapped from Sitecore 8.x to 9 in xDB Migration Tool. - [Page events](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/page-events.md): Guide to the Page events in xDB Data Migration Tool. - [Page events - outcomes](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/page-events---outcomes.md): Guide to how outcomes are mapped from Sitecore 8.x to 9 in xDB Migration Tool. - [Page events - personalization](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/page-events---personalization.md): Guide to how personalization events are mapped from Sitecore 8.x to 9 in xDB Migration Tool. - [Page Events - content testing](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/page-events---content-testing.md): Guide to how events from MV tests are mapped from Sitecore 8.x to Sitecore 9 by xDB Migration Tool. - [Page events - EXM](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/page-events---exm.md): Guide to how email related events are mapped from Sitecore 8.x to 9 in xDB Migration Tool. - [Device profiles](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/device-profiles.md): How xDB Migration Tool maps device profile data from Sitecore 8.x to Sitecore 9. - [Reference data](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/reference-data.md): Introduction to what reference data xDB Data Migration Tool maps from Sitecore 8.x to Sitecore 9. - [Geo IPs](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/geo-ips.md): How xDB Data Migration Tool maps Geo IP data from Sitecore 8.x to Sitecore 9. - [Locations](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/locations.md): How xDB Data Migration Tool maps location data from Sitecore 8.x to Sitecore 9. ### Commerce mappings - [Commerce mappings](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/commerce-mappings.md): Introduction to how xDB Data Mapping Tool supports commerce data. - [Installation](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/installation.md): How to install commerce data support in xDB Data Migration Tool. - [Prerequisites](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/prerequisites.md): Prerequisites for installing support for commerce data in the xDB Data Migration Tool. - [Installing Sitecore components](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/installing-sitecore-components.md): How to add support for commerce data to the xDB Data Migration Tool. - [Upgrading the tenant](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/upgrading-the-tenant.md): How to upgrade commerce data tenants when you have upgraded the Data Exchange Framework SDK. - [Deploying collection models to xConnect](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/deploying-collection-models-to-xconnect.md): How to deploy commerce collection models to your xConnect servers for use in xDB Data Migration Tool. - [Using a custom xConnect collection model](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/using-a-custom-xconnect-collection-model.md): Introduction to creating a collection model for xConnect in order to use xDB Data Migration tool to migrate custom data in MongoDB. - [Interactions](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/interactions-278144.md): Introduction to which commerce interaction data can be mapped by xDB Data Migration Tool. - [Commerce page events](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/commerce-page-events.md): Guide to how commerce page events are mapped using event converters in xDB Data Mapping Tool. - [Commerce page events - outcomes](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/commerce-page-events---outcomes.md): Guide to how commerce outcomes are mapped using outcome converters in xDB Data Mapping Tool. ### Adding custom data - [Adding custom data](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/adding-custom-data.md): Introduction to how add support for custom data to xDB Data Migration Tool. - [Entity facets](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/entity-facets.md): Introduction to how to map custom entity facets from Sitecore 8.x to Sitecore 9.0 using xDB Data Migration Tool. - [Determine the data to migrate](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/determine-the-data-to-migrate.md): How to determine which data you wish to migrate from Sitecore 8.x to Sitecore 9, using xDB Data Migration Tool. - [Determine where to store the migrated data](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/determine-where-to-store-the-migrated-data.md): Introduction to determining data structures for storing data migrated from Sitecore 8.x to Sitecore 9 using xDB Data Migration Tool. - [Implement components to store migrated data](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/implement-components-to-store-migrated-data.md): How to create and deploy the facet and model components needed to store migrated data using xDB Migration Tool. - [Map data from MongoDB to contact facet](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/map-data-from-mongodb-to-contact-facet.md): How to map contact data from MongoDB to an xConnect contact facet in xDB Data MIgration Tool. - [Walkthrough: Migrating a custom facet with complex types](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/walkthrough--migrating-a-custom-facet-with-complex-types.md): Example of how to migrate complex data types into xConnect facets. - [Run pipeline batch](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/run-pipeline-batch.md): Guide to running a migration of contact data from MongoDB to Xconnect, and checking the result, in xDB Data Migration Tool. - [Contact identifiers](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/contact-identifiers.md): Introduction to adding a custom contact identifier when mapping data from MongoDB to xConnect in xDB Data Migration Tool. - [Determine the data for the contact identifier](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/determine-the-data-for-the-contact-identifier.md): Guide to basic settings for custom contact identifiers in xDB Data Migration Tool. - [Map data from MongoDB to contact identifier](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/map-data-from-mongodb-to-contact-identifier.md): How to map MongoDB data to an xConnect contact identifier in xDB Data Migration Tool. - [Run pipeline batch](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/run-pipeline-batch-278157.md): How to run the migration of contact data from MongoDB to xConnect with xDB Data Migration Tool. - [Events on interactions](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/events-on-interactions.md): Introduction to mapping custom page events from Sitecore 8.x to Sitecore 9.0 using xDB Migration Tool. - [Custom event with no custom data](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/custom-event-with-no-custom-data.md): How to use xDB Migration Tool to handle a custom event without custom data. - [Custom event with custom data that maps without transformation](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/custom-event-with-custom-data-that-maps-without-transformation.md): How to use xDB Migration Tool to map a custom event with custom data where the data does not have to be transformed. - [Custom event with custom data that maps with transformation](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/custom-event-with-custom-data-that-maps-with-transformation.md): How to use xDB Migration Tool to map a custom event with custom data where the data is being transformed. ## Optional - [Full publication as Markdown](https://doc.sitecore.com/xp/en/developers/dmt/21/xdb-data-migration-tool/llms-full.txt): Every article in this publication in a single file. - [Version 5.0](https://doc.sitecore.com/xp/en/developers/dmt/50/xdb-data-migration-tool/llms.txt): Current. - [Version 4.0](https://doc.sitecore.com/xp/en/developers/dmt/40/xdb-data-migration-tool/llms.txt): Previous version. - [Version 3.0](https://doc.sitecore.com/xp/en/developers/dmt/30/xdb-data-migration-tool/llms.txt): Previous version. - [Version 2.0](https://doc.sitecore.com/xp/en/developers/dmt/20/xdb-data-migration-tool/llms.txt): Previous version.