---
title: "Email addresses facet"
slug: "email-addresses-facet"
abstract: "Guide to the email addresses facet and its properties in xDB Data Migration Tool."
---
# Email addresses facet

<details>
<summary><h2>Format in Sitecore 8.x</h2></summary>

In Sitecore 8.x, email addresses are associated with a contact through a property on the contact. The name of the property is `Emails`.

The following is an example the `Emails` property on the contact:

```csharp
"Emails" : {
    "Preferred" : "work",
    "Entries" : {
        "work" : {
            "SmtpAddress" : "thomas@shelbybros.co.uk",
            "BounceCount" : 0
        },
        "home" : {
            "SmtpAddress" : "tommydigs@gmail.com",
            "BounceCount" : 0
        }
    }
}
```

The `Entries` property is a dictionary. Each member of the dictionary has a key and a value. The key describes the email address. The value is an object that contains the details of the email address.

In addition to the `Entries` property, the `Emails` object has another property named `Preferred`. The value is the key for one of the email addresses.

</details>

<details>
<summary><h2>Format in Sitecore 9</h2></summary>

In Sitecore 9, email addresses are associated with a contact through a contact facet:

|     |     |
| --- | --- |
| Facet Name | `Emails` |
| Facet Type | `Sitecore.XConnect.Collection.Model.EmailAddressList` |

in Sitecore 9, the preferred email address is stored separate from the other email addresses, unlike in Sitecore 8.x where all email addresses are stored in a single dictionary.

| Facet Property | Description |
| --- | --- |
| `PreferredEmail` | Object that represents the preferred email address |
| `PreferredKey` | Key for the preferred email address |
| `Others` | Dictionary that contains all other email addresses associated with the contact |

</details>

<details>
<summary><h2>Mapping email address properties</h2></summary>

|     |     |
| --- | --- |
| Source object | Member of the dictionary located at `Emails.Entries` on the contact document |
| Target object | `Sitecore.XConnect.Collection.Model.EmailAddress` |
| Mapping definition | MongoDB to xConnect Contact Mappings > MongoDB Email to xConnect Contact Email Address |

| Value to write to target object | Property on target object |
| --- | --- |
| `BounceCount` from source object | `BounceCount` |
| `SmtpAddress` from source object | `SmtpAddress` |
| `false` | `Validated` |

</details>