<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macOS: 13.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "BundleResources",
  "identifier" : "/documentation/BundleResources/Entitlements/com.apple.developer.contacts.notes",
  "metadataVersion" : "0.1.0",
  "role" : "Property List Key",
  "symbol" : {
    "kind" : "Property List Key",
    "modules" : [
      "Bundle Resources"
    ],
    "preciseIdentifier" : "entitlements:Entitlements.com.apple.developer.contacts.notes"
  },
  "title" : "com.apple.developer.contacts.notes"
}
-->

# com.apple.developer.contacts.notes

A Boolean value that indicates whether the app may access the notes in contact entries.

## Discussion

When your app loads one or more entries from the user’s contacts — for example, by calling the <doc://com.apple.documentation/documentation/Contacts/CNContactStore/unifiedContacts(matching:keysToFetch:)> method — you provide a list of keys specifying the fields to fetch. To request the <doc://com.apple.documentation/documentation/Contacts/CNContact/note> field using <doc://com.apple.documentation/documentation/Contacts/CNContactNoteKey> in iOS 13 or later or macOS 13 or later, your app must have the [`com.apple.developer.contacts.notes`](/documentation/BundleResources/Entitlements/com.apple.developer.contacts.notes) entitlement. When your app tries to fetch notes without the entitlement, it receives an <doc://com.apple.documentation/documentation/Contacts/CNError/unauthorizedKeys> error. Your app only needs the entitlement if it reads or writes notes.

Add the entitlement to your app in the Xcode property list editor. Set the entitlement’s type to Boolean, and the corresponding value to `YES`.

![A screenshot of Xcode showing the contact notes entitlement in an app’s entitlements file.](images/com.apple.bundleresources/media-3368935@2x.png)

Before you submit an app with this entitlement to the App Store, you need to get permission to use the entitlement. Request permission at <https://developer.apple.com/contact/request/contact-note-field>.

---

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)