---
title: CNContactProperty
framework: contacts
role: symbol
role_heading: Class
path: contacts/cncontactproperty
---

# CNContactProperty

An object that represents a property of a contact.

## Declaration

```swift
class CNContactProperty
```

## Overview

Overview A contact (that is, an instance of CNContact) has properties, such as givenName, phoneNumbers, and jobTitle. Each property is represented by an instance of CNContactProperty, which provides a tuple that can contain three or five values, depending on whether the property is a member of an array of labeled values. For example, the phoneNumbers property is a member of an array of labeled values, so the CNContactProperty tuple contains the contact, key, value, identifier, and label. For the givenName property, which is not contained in a labeled array, CNContactProperty returns a tuple that contains the contact, key, and value. The CNContactProperty class is used by CNContactPicker to return the user’s selected property.

## Topics

### Getting the Contact Object

- [contact](contacts/cncontactproperty/contact.md)

### Getting the Property Information

- [key](contacts/cncontactproperty/key.md)
- [value](contacts/cncontactproperty/value.md)
- [label](contacts/cncontactproperty/label.md)
- [identifier](contacts/cncontactproperty/identifier.md)

### Handling Exceptions

- [CNContactPropertyNotFetchedExceptionName](contacts/cncontactpropertynotfetchedexceptionname.md)

### Initializers

- [init(coder:)](contacts/cncontactproperty/init(coder:).md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCoding](foundation/nscoding.md)
- [NSCopying](foundation/nscopying.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSSecureCoding](foundation/nssecurecoding.md)

## See Also

### Generic Types

- [CNLabeledValue](contacts/cnlabeledvalue.md)