Phone Numbers Facet

Format in Sitecore 8.x

In Sitecore 8.x, phone numbers are associated with a contact through a property on the contact. The name of the property is Phone Numbers.

The following is an example the Phone Numbers property on the contact:

"Phone Numbers" : {
    "Preferred" : "work",
    "Entries" : {
        "work" : {
            "CountryCode" : "+44",
            "Extension" : "123",
            "Number" : "0121 496 0208"
        "home" : {
            "CountryCode" : "+44",
            "Extension" : "987",
            "Number" : "0121 496 0208"

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

In addition to the Entries property, the Phone Numbers object has another property named Preferred. The value is the key for one of the phone numbers.

Format in Sitecore 9

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

Facet Name PhoneNumbers
Facet Type Sitecore.XConnect.Collection.Model.PhoneNumberList

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

Facet Property Description
PreferredPhoneNumber Object that represents the preferred phone number
PreferredKey Key for the preferred phone number
Others Dictionary that contains all other phone numbers associated with the contact

Mapping Phone Number Properties

Source object Member of the dictionary located at Phone Numbers.Entries on the contact document
Target object Sitecore.XConnect.Collection.Model.PhoneNumber
Mapping definition MongoDB to xConnect Contact Mappings > MongoDB Phone Number to xConnect Contact Phone Number
Value to write to target object Property on target object
CountryCode from source object CountryCode
Extension from source object Extension
Number from source object Number