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

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

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

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

```csharp
"Addresses" : {
    "Preferred" : "home",
    "Entries" : {
        "home" : {
            "Country" : "United Kingdom",
            "City" : "Birmingham",
            "PostalCode" : "B45 8GW",
            "StreetLine1" : "10 Foundry Road",
            "Location" : {
                "Longitude" : -0.118092000484467,
                "Latitude" : 51.5098648071289
            }
        },
        "work" : {
            "Country" : "United Kingdom",
            "City" : "London",
            "PostalCode" : "W1T 4JE",
            "StreetLine1" : "15 Kingshire Abbey"
        }
    }
}
```

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

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

</details>

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

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

|     |     |
| --- | --- |
| Facet Name | `Addresses` |
| Facet Type | `Sitecore.XConnect.Collection.Model.AddressList` |

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

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

</details>

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

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

| Value to write to target object | Property on target object |
| --- | --- |
| `City` from source object | `City` |
| `Country` from source object | `CountryCode` |
| `PostalCode` from source object | `PostalCode` |
| `StateProvince` from source object | `StateOrProvince` |
| `StreetLine1` from source object | `AddressLine1` |
| `StreetLine2` from source object | `AddressLine2` |
| `StreetLine3` from source object | `AddressLine3` |
| `StreetLine4` from source object | `AddressLine4` |

</details>