<!--
{
  "documentType" : "article",
  "framework" : "Contacts",
  "identifier" : "/documentation/Contacts/contact-keys",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Contact Keys"
}
-->

# Contact Keys

Specify contact-related properties during fetch operations.

## Topics

### Contact Identification

[`CNContactIdentifierKey`](/documentation/Contacts/CNContactIdentifierKey)

The contact’s unique identifier.

[`CNContactTypeKey`](/documentation/Contacts/CNContactTypeKey)

The type of contact.

[`CNContactPropertyAttribute`](/documentation/Contacts/CNContactPropertyAttribute)

The contact’s name component property key.

### Name

[`CNContactNamePrefixKey`](/documentation/Contacts/CNContactNamePrefixKey)

The prefix for the contact’s name.

[`CNContactGivenNameKey`](/documentation/Contacts/CNContactGivenNameKey)

The contact’s given name.

[`CNContactMiddleNameKey`](/documentation/Contacts/CNContactMiddleNameKey)

The contact’s middle name.

[`CNContactFamilyNameKey`](/documentation/Contacts/CNContactFamilyNameKey)

The contact’s family name.

[`CNContactPreviousFamilyNameKey`](/documentation/Contacts/CNContactPreviousFamilyNameKey)

The contact’s previous family name.

[`CNContactNameSuffixKey`](/documentation/Contacts/CNContactNameSuffixKey)

The contact’s name suffix.

[`CNContactNicknameKey`](/documentation/Contacts/CNContactNicknameKey)

The contact’s nickname.

[`CNContactPhoneticGivenNameKey`](/documentation/Contacts/CNContactPhoneticGivenNameKey)

The phonetic spelling of the contact’s  given name.

[`CNContactPhoneticMiddleNameKey`](/documentation/Contacts/CNContactPhoneticMiddleNameKey)

The phonetic spelling of the contact’s middle name.

[`CNContactPhoneticFamilyNameKey`](/documentation/Contacts/CNContactPhoneticFamilyNameKey)

The phonetic spelling of the contact’s family name.

### Work

[`CNContactJobTitleKey`](/documentation/Contacts/CNContactJobTitleKey)

The contact’s job title.

[`CNContactDepartmentNameKey`](/documentation/Contacts/CNContactDepartmentNameKey)

The contact’s department name.

[`CNContactOrganizationNameKey`](/documentation/Contacts/CNContactOrganizationNameKey)

The contact’s organization name.

[`CNContactPhoneticOrganizationNameKey`](/documentation/Contacts/CNContactPhoneticOrganizationNameKey)

The phonetic spelling of the contact’s organization name.

### Addresses

[`CNContactPostalAddressesKey`](/documentation/Contacts/CNContactPostalAddressesKey)

The postal addresses of the contact.

[`CNContactEmailAddressesKey`](/documentation/Contacts/CNContactEmailAddressesKey)

The email addresses of the contact.

[`CNContactUrlAddressesKey`](/documentation/Contacts/CNContactUrlAddressesKey)

The URL addresses of the contact.

[`CNContactInstantMessageAddressesKey`](/documentation/Contacts/CNContactInstantMessageAddressesKey)

The instant message addresses of the contact.

### Phone

[`CNContactPhoneNumbersKey`](/documentation/Contacts/CNContactPhoneNumbersKey)

A phone numbers of a contact.

### Social Profiles

[`CNContactSocialProfilesKey`](/documentation/Contacts/CNContactSocialProfilesKey)

A social profiles of a contact.

### Birthday

[`CNContactBirthdayKey`](/documentation/Contacts/CNContactBirthdayKey)

The birthday of a contact.

[`CNContactNonGregorianBirthdayKey`](/documentation/Contacts/CNContactNonGregorianBirthdayKey)

The non-Gregorian birthday of the contact.

[`CNContactDatesKey`](/documentation/Contacts/CNContactDatesKey)

Dates associated with a contact.

### Notes

[`CNContactNoteKey`](/documentation/Contacts/CNContactNoteKey)

A note associated with a contact.

  <doc://com.apple.documentation/documentation/BundleResources/Entitlements/com.apple.developer.contacts.notes>

### Images

[`CNContactImageDataKey`](/documentation/Contacts/CNContactImageDataKey)

Image data for a contact.

[`CNContactThumbnailImageDataKey`](/documentation/Contacts/CNContactThumbnailImageDataKey)

Thumbnail data for a contact.

[`CNContactImageDataAvailableKey`](/documentation/Contacts/CNContactImageDataAvailableKey)

Image data availability for a contact.

### Relationships

[`CNContactRelationsKey`](/documentation/Contacts/CNContactRelationsKey)

The relationships of the contact.

### Groups and Containers

[`CNGroupNameKey`](/documentation/Contacts/CNGroupNameKey)

The name of the group.

[`CNGroupIdentifierKey`](/documentation/Contacts/CNGroupIdentifierKey)

The identifier of the group.

[`CNContainerNameKey`](/documentation/Contacts/CNContainerNameKey)

The name of the container.

[`CNContainerTypeKey`](/documentation/Contacts/CNContainerTypeKey)

The type of the container.

### Instant Messaging Keys

[`CNInstantMessageAddressServiceKey`](/documentation/Contacts/CNInstantMessageAddressServiceKey)

Instant message address service key.

[`CNInstantMessageAddressUsernameKey`](/documentation/Contacts/CNInstantMessageAddressUsernameKey)

Instant message address username key.

### Social Profile Keys

[`CNSocialProfileServiceKey`](/documentation/Contacts/CNSocialProfileServiceKey)

The social profile service.

[`CNSocialProfileURLStringKey`](/documentation/Contacts/CNSocialProfileURLStringKey)

The social profile URL.

[`CNSocialProfileUsernameKey`](/documentation/Contacts/CNSocialProfileUsernameKey)

The social profile user name.

[`CNSocialProfileUserIdentifierKey`](/documentation/Contacts/CNSocialProfileUserIdentifierKey)

The social profile user identifier.

### Key Descriptors

[`CNKeyDescriptor`](/documentation/Contacts/CNKeyDescriptor)

This protocol is reserved for Contacts framework usage.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)