---
title: "Entity facets"
slug: "entity-facets"
abstract: "Introduction to how to map custom entity facets from Sitecore 8.x to Sitecore 9.0 using xDB Data Migration Tool."
---
# Entity facets

This section explains how to map custom entity facets from Sitecore 8.x to Sitecore 9.0.

An example is used to guide you through the process. In this example, a custom contact facet is used to store information about a customer loyalty program that the contact is enrolled in.

> [!note]
> This example uses contact facets, but adding interaction facets is done in the same way.

- [Determine the data to migrate](https://doc.sitecore.com/xp/en/developers/dmt/50/xdb-data-migration-tool/determine-the-data-to-migrate.html "Determine the data to migrate")
- [Determine where to store the migrated data](https://doc.sitecore.com/xp/en/developers/dmt/50/xdb-data-migration-tool/determine-where-to-store-the-migrated-data.html "Determine where to store the migrated data")
- [Implement components to store migrated data](https://doc.sitecore.com/xp/en/developers/dmt/50/xdb-data-migration-tool/implement-components-to-store-migrated-data.html "Implement components to store migrated data")
    - Create facet
    - Create model
    - Deploy components to the Sitecore server
    - Register model with Data Exchange Framework
    - Deploy model to xConnect
- [Map data from MongoDB to contact facet](https://doc.sitecore.com/xp/en/developers/dmt/50/xdb-data-migration-tool/map-data-from-mongodb-to-contact-facet.html "Map data from MongoDB to contact facet")
    - Update the xConnect endpoint
    - Update the pipeline step that resolves the contact model
    - Specify data to read from MongoDB
    - Specify data to write to xConnect contact facet
    - Configure mapping from MongoDB contact to xConnect contact facet
    - Specify how xConnect contact facet is populated
    - Add mapping for xConnect contact facet to entity model for contact
- [Run pipeline batch](https://doc.sitecore.com/xp/en/developers/dmt/50/xdb-data-migration-tool/run-pipeline-batch.html "Run pipeline batch")
    - xConnect collection database
    - xConnect search