<!--
{
  "availability" : [
    "iOS: 9.0.0 -",
    "iPadOS: 9.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.11.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Contacts",
  "identifier" : "/documentation/Contacts/CNMutableContact",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Contacts"
    ],
    "preciseIdentifier" : "c:objc(cs)CNMutableContact"
  },
  "title" : "CNMutableContact"
}
-->

# CNMutableContact

A mutable object that stores information about a single contact, such as the contact’s first name, phone numbers, and addresses.

```
class CNMutableContact
```

## Overview

`CNMutableContact` objects are not a thread-safe class. To access the contact information in a thread-safe manner, use a [`CNContact`](/documentation/Contacts/CNContact) object instead.

You may modify only those properties whose values you fetched from the contacts database. When fetching a contact, you specify which properties you want to retrieve from the database. The contact store then populates the properties of a [`CNContact`](/documentation/Contacts/CNContact) object with those values. After creating a mutable copy of that object, you can modify only those properties for which a value exists. If you attempt to access a property that is not available, the `CNMutableContact` object throws a [`CNContactPropertyNotFetchedExceptionName`](/documentation/Contacts/CNContactPropertyNotFetchedExceptionName) exception.

To remove the value for a property, set string and array properties to empty, and set all other properties to `nil`.

## Topics

### Setting the Identity of the Contact

[`contactType`](/documentation/Contacts/CNMutableContact/contactType)

An enum identifying the contact type.

### Setting Name Information

[`namePrefix`](/documentation/Contacts/CNMutableContact/namePrefix)

The name prefix of the contact.

[`givenName`](/documentation/Contacts/CNMutableContact/givenName)

The given name of the contact.

[`middleName`](/documentation/Contacts/CNMutableContact/middleName)

The middle name of the contact.

[`familyName`](/documentation/Contacts/CNMutableContact/familyName)

The family name of the contact.

[`previousFamilyName`](/documentation/Contacts/CNMutableContact/previousFamilyName)

The previous family name of the contact.

[`nameSuffix`](/documentation/Contacts/CNMutableContact/nameSuffix)

The name suffix of the contact.

[`nickname`](/documentation/Contacts/CNMutableContact/nickname)

The nickname of the contact.

[`phoneticGivenName`](/documentation/Contacts/CNMutableContact/phoneticGivenName)

The phonetic given name of the contact.

[`phoneticMiddleName`](/documentation/Contacts/CNMutableContact/phoneticMiddleName)

The phonetic middle name of the contact.

[`phoneticFamilyName`](/documentation/Contacts/CNMutableContact/phoneticFamilyName)

The phonetic family name of the contact.

### Setting Work Information

[`jobTitle`](/documentation/Contacts/CNMutableContact/jobTitle)

The contact’s job title.

[`departmentName`](/documentation/Contacts/CNMutableContact/departmentName)

The name of the department associated with the contact.

[`organizationName`](/documentation/Contacts/CNMutableContact/organizationName)

The name of the organization associated with the contact.

[`phoneticOrganizationName`](/documentation/Contacts/CNMutableContact/phoneticOrganizationName)

The phonetic name of the organization associated with the contact.

### Setting Addresses

[`postalAddresses`](/documentation/Contacts/CNMutableContact/postalAddresses)

An array of labeled postal addresses for a contact.

[`emailAddresses`](/documentation/Contacts/CNMutableContact/emailAddresses)

An array of labeled email addresses for the contact.

[`urlAddresses`](/documentation/Contacts/CNMutableContact/urlAddresses)

An array of labeled URL addresses for a contact.

### Setting Phone Information

[`phoneNumbers`](/documentation/Contacts/CNMutableContact/phoneNumbers)

An array of labeled phone numbers for a contact.

### Setting Social Profiles

[`socialProfiles`](/documentation/Contacts/CNMutableContact/socialProfiles)

An array of labeled social profiles for a contact.

### Setting Birthday Information

[`dates`](/documentation/Contacts/CNMutableContact/dates)

An array containing labeled Gregorian dates.

[`nonGregorianBirthday`](/documentation/Contacts/CNMutableContact/nonGregorianBirthday)

A date component for the non-Gregorian birthday of the contact.

[`birthday`](/documentation/Contacts/CNMutableContact/birthday)

A date component for the Gregorian birthday of the contact.

### Setting Notes

[`note`](/documentation/Contacts/CNMutableContact/note)

A string containing notes for the contact.

### Setting Images

[`imageData`](/documentation/Contacts/CNMutableContact/imageData)

The profile picture of a contact.

### Relating Other Information to the Contact

[`contactRelations`](/documentation/Contacts/CNMutableContact/contactRelations)

An array of labeled contact relations for the contact.

[`instantMessageAddresses`](/documentation/Contacts/CNMutableContact/instantMessageAddresses)

An array of labeled IM addresses for the contact.

## Relationships

### Conforms To

[`NSMutableCopying`](/documentation/Foundation/NSMutableCopying)

[`NSSecureCoding`](/documentation/Foundation/NSSecureCoding)

[`Identifiable`](/documentation/Swift/Identifiable)

[`NSCopying`](/documentation/Foundation/NSCopying)

[`NSItemProviderReading`](/documentation/Foundation/NSItemProviderReading)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`NSCoding`](/documentation/Foundation/NSCoding)

[`Hashable`](/documentation/Swift/Hashable)

[`Equatable`](/documentation/Swift/Equatable)

[`CVarArg`](/documentation/Swift/CVarArg)

[`NSItemProviderWriting`](/documentation/Foundation/NSItemProviderWriting)

### Inherits From

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

---

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)