Skip to Content
Platform.Ontology

Purpose strings and review rejection

Every iOS privacy prompt needs a written reason in the app, or the app is rejected or crashes.

Works without askingOther apps on the phonePolicyAndroid and iPhoneWhen the app opens

In one line

Can't ask for iPhone access without a written reason shown in the prompt

Every iOS privacy prompt needs a written reason in the app, or the app is rejected or crashes.

The string is the only text the person sees about why. Apple reviewers reject vague ones, and a missing key crashes the app.

What it can and can't do

What the user does: Nothing. You see the reason when the app first asks for a camera, location or photos

It can

  • Show you a sentence explaining why it wants an item, on iPhone
  • Show its own explanation before an Android permission box
  • Ask again later only if the reason text exists

It cannot

  • Ask for a protected item on iPhone with no reason text; the app would close
  • Pass App Store review with a vague reason such as We need this
  • Change the reason text after release without a new app version

How it differs between platforms: iPhone requires the reason text in the app. Android has no system reason text; the developer fills a Data safety form in Play Console instead.

On Android and iPhone

AndroidiPhone
StatusSupportedSupported
First versionAndroid 6.0 (API 23)iOS 10
Permission or entitlementNone; rationale UI optionalNS*UsageDescription keys in Info.plist
Protection levelnoneprompt
How access is grantednoneprompt
What the user seesOptional rationale shown by appPrompt text comes from the key
How long it lastsn/an/a
How to take it backn/an/a
Store policyPlay: Data safety form and permission declarationsApp Review 5.1.1 and 5.1.2
APIshouldShowRequestPermissionRationaleInfo.plist
NotesNo system purpose text; Data safety form is declared in Play ConsoleMissing key for a used API terminates the app; privacy manifests required from spring 2024

Data you get

What comes back: Info.plist string
Shape: none
How often: static

FieldTypeUnitRangePrecision
keyslistNS*UsageDescriptionover 40Not listed

Technical limits

  • Apple may reject vague text
  • Data safety form on Google Play

The story

What it is

A short written reason an iOS app must show before it asks for something private.

For you

The permission pop up has one sentence from the app explaining why it wants your camera, location or contacts. That sentence is often your only clue about what you are agreeing to.

For makers

Apple will reject an app if the reason is vague, and the app crashes if the reason is missing. Good makers write clear sentences that raise yes rates, because people say yes when they see a real benefit.

Where you see it

TypeExampleApps
mapsA rideshare app writes 'Your location is used to show nearby drivers' so the Allow button feels fair.Uber, Lyft
socialA photo sharing app says 'We need camera access so you can post photos' and avoids a rejection.Instagram, Snapchat
gamesAn AR game explains the camera use as 'to place creatures in your world', which lifts tap through on Allow.Pokemon GO
datingA dating app writes why it wants location before it shows matches nearby.Hinge, Tinder
fitnessA running app writes 'We track your route while you run, even when the screen is off' for the background location prompt.Strava, Nike Run Club
developerAn app review team bounces a build because the microphone string only said 'Microphone needed'.None named

Risks

  • Vague wording tricks people
  • Missing keys crash apps

Android and iPhone in short

  • Android: Android has no required explanation text, though Google Play asks for a reason in review forms.
  • iPhone: iOS requires one text key for each private feature and shows it in the system prompt.

What the platform says

Good uses and abuse

Legitimate uses

  • Informed consent

Known abuse

  • Vague or misleading reasons

Scores

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

History

  • 2016-09, iPhone iOS 10: Purpose strings required for privacy APIs, crash if missing
  • 2024-05, iPhone iOS 17: Privacy manifests and required reason APIs enforced

Sources

How well checked: Based on official documentation.

On this page