Contact notes field
Apps cannot read free-text notes on contacts without an Apple entitlement.
In one line
Can't see the Notes field on contacts on iPhone without Apple's special approval
Apps cannot read free-text notes on contacts without an Apple entitlement.
Notes often hold passwords, door codes and medical details. Apple walled them off after reports of misuse.
What it can and can't do
What the user does: Nothing. It is blocked when the app asks for notes without the entitlement
It can
- Open names, numbers and emails if you allowed contacts
- See notes on Android with the normal contacts permission
- See notes on iPhone only if Apple approved the entitlement
It cannot
- Get passwords, door codes or medical notes on iPhone without the entitlement
- Fetch the notes field on iPhone without an error
- Ask you to approve notes with an extra pop up; Apple reviews the request instead
How it differs between platforms: Android has no separate gate for notes; iPhone needs an Apple entitlement.
On Android and iPhone
| Android | iPhone | |
|---|---|---|
| Status | Not supported | Not supported |
| First version | Android 1.0 (API 1) | iOS 13 |
| Permission or entitlement | READ_CONTACTS (notes are a normal Data row) | com.apple.developer.contacts.notes |
| Protection level | dangerous | entitlement |
| How access is granted | not-exposed | not-exposed |
| What the user sees | Same as contacts | No extra prompt; Apple must approve the entitlement request |
| How long it lasts | Until revoked | Tied to the provisioning profile |
| How to take it back | Settings > Apps > Permissions > Contacts | n/a |
| Store policy | Play contacts sensitive data policy | App Review approves business justification |
| API | ContactsContract.CommonDataKinds.Note | CNContactNoteKey |
| Notes | No separate gate on Android | Without the entitlement, fetching the note key throws an error |
Data you get
What comes back: Free text
Shape: string
How often: on read
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
note | string | text | any length | Not listed |
Technical limits
- Apple review needed for each app
- No Android equivalent
The story
What it is
A gate that blocks apps from reading the free text notes on your contacts unless Apple approves.
For you
You never notice it. Apps with contacts access see names and numbers, but not the notes you wrote, such as door codes or a friend's allergies. The notes stay private.
For makers
Notes often hold passwords, door codes and medical facts. Apple walled them off after reports that some apps were reading them. Apps that want them, like an enterprise CRM, must apply for an entitlement and explain why.
Where you see it
| Type | Example | Apps |
|---|---|---|
| enterprise | A company sales app wanted notes on contacts so reps see past call details, and has to ask Apple. | None named |
| productivity | A contact merge tool wanted to keep notes when cleaning duplicates and now has to work around the block. | None named |
| security | A backup app wanted to copy full contacts including notes, and cannot without approval. | None named |
| social | A growth team wanted to scrape notes for hints about friends' birthdays. | None named |
| health | A care app wanted to read care notes you saved for a parent. | None named |
| analytics | A data broker wanted notes as a free text signal and is stopped. | None named |
| developer | A developer sees a crash when fetching the notes key and has to apply. | None named |
Risks
- Backups may miss notes
- Notes stay in plain text
- Approval bar for CRMs
Android and iPhone in short
- Android: Android has no separate gate for notes.
- iPhone: Without the entitlement, asking for the notes field throws an error.
Good uses and abuse
Legitimate uses
- Enterprise CRM
Known abuse
- Stealing secrets stored in notes
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 5 of 5 | How revealing the data is |
| Utility | 2 of 5 | How useful it is to honest apps |
| Friction | 3 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2019-09, iPhone iOS 13: Notes field requires com.apple.developer.contacts.notes
Related capabilities
Related
- Contacts, read and write. Can open your whole address book once you allow it, or only some on iPhone
Sources
How well checked: Based on official documentation.