Addresses Facet

Format in Sitecore 8.x

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:

"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.

Format in Sitecore 9

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

Facet Name Addresses
Facet Type Sitecore.XConnect.Collection.Model.AddressList

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

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

Mapping Address Properties

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