Skip to Content
Platform.Ontology

Contact notes field

Apps cannot read free-text notes on contacts without an Apple entitlement.

Blocked for appsContacts and personal dataAddress bookAndroid and iPhoneWhile you use it

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

AndroidiPhone
StatusNot supportedNot supported
First versionAndroid 1.0 (API 1)iOS 13
Permission or entitlementREAD_CONTACTS (notes are a normal Data row)com.apple.developer.contacts.notes
Protection leveldangerousentitlement
How access is grantednot-exposednot-exposed
What the user seesSame as contactsNo extra prompt; Apple must approve the entitlement request
How long it lastsUntil revokedTied to the provisioning profile
How to take it backSettings > Apps > Permissions > Contactsn/a
Store policyPlay contacts sensitive data policyApp Review approves business justification
APIContactsContract.CommonDataKinds.NoteCNContactNoteKey
NotesNo separate gate on AndroidWithout the entitlement, fetching the note key throws an error

Data you get

What comes back: Free text
Shape: string
How often: on read

FieldTypeUnitRangePrecision
notestringtextany lengthNot 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

TypeExampleApps
enterpriseA company sales app wanted notes on contacts so reps see past call details, and has to ask Apple.None named
productivityA contact merge tool wanted to keep notes when cleaning duplicates and now has to work around the block.None named
securityA backup app wanted to copy full contacts including notes, and cannot without approval.None named
socialA growth team wanted to scrape notes for hints about friends' birthdays.None named
healthA care app wanted to read care notes you saved for a parent.None named
analyticsA data broker wanted notes as a free text signal and is stopped.None named
developerA 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

ScoreValueMeaning
Sensitivity5 of 5How revealing the data is
Utility2 of 5How useful it is to honest apps
Friction3 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2019-09, iPhone iOS 13: Notes field requires com.apple.developer.contacts.notes

Sources

How well checked: Based on official documentation.

On this page