Skip to Content
Platform.Ontology

Required Reason: UserDefaults

iOS UserDefaults access needs a reason code such as CA92.1 (app only) or 1C8F.1 (app group).

Works without askingFiles and storagePrivacy manifestsAndroid and iPhoneWhen the app opensWhile you use it

In one line

Can keep its own saved settings on iPhone, but must give Apple a reason

iOS UserDefaults access needs a reason code such as CA92.1 (app only) or 1C8F.1 (app group).

Shared defaults can leak info across apps. CA92.1 is app-only data, 1C8F.1 is data shared in one app group, C56D.1 is an SDK wrapper, AC6B.1 reads managed configuration.

What it can and can't do

What the user does: Nothing. The app stores settings quietly as you use it

It can

  • Save its own settings and choices, with a stated reason on iPhone
  • Share settings with apps in the same developer group on iPhone
  • Save settings on Android with no gate, in the app's own private area

It cannot

  • Use it to see other apps' settings; the data stays in the app or its group
  • Skip the stated reason on iPhone; App Store review checks it
  • Use it to track you across other developers' apps
  • Share settings across developers on Android

How it differs between platforms: Android keeps preferences app private and has no gate. iPhone needs a declared reason code.

On Android and iPhone

AndroidiPhone
StatusNot supportedBehind a flag
First versionNot availableiOS 17.0
Permission or entitlementnoneentitlement
Protection levelnoneentitlement
How access is grantednot-exposednone
What the user seesNot listedNot listed
How long it lastsNot listedNot listed
How to take it backNot listedApp Review: reason must match use
Store policyNone listedNone listed
APIAndroid has no gate: SharedPreferences is app-privateCA92.1 app-only; 1C8F.1 same app group; C56D.1 SDK wrapper only; AC6B.1 managed app config
NotesAndroid analog: no reason neededNone

Data you get

What comes back: Reason codes
Shape: object
How often: At upload

FieldTypeUnitRangePrecision
reason_codeslistcode4 valuesexact

Technical limits

  • Cannot read data of other apps

The story

What it is

iOS makes apps give an approved reason before using a shared settings store.

For you

You never see it. UserDefaults is where apps save small settings. Apple makes apps explain why they use it, so no app quietly reads another app's data.

For makers

Makers choose a reason code, like CA92.1 for the app's own data or 1C8F.1 for an app group. Sharing across companies is not allowed.

Where you see it

TypeExampleApps
productivityA notes app saves your theme choice and declares CA92.1.None named
gamesA game saves your sound setting and declares CA92.1.None named
enterpriseA work app reads settings set by a company manager and declares AC6B.1.None named
developerAn SDK wraps defaults for the app and declares C56D.1.None named
mediaA music app shares settings with its widget through an app group and declares 1C8F.1.None named
adsA tracker that reads settings shared with other apps is flagged.None named

Risks

  • Reason may be misused
  • Shared defaults can leak data

Android and iPhone in short

  • Android: Android has no matching rule.
  • iPhone: Enforced through the privacy manifest and App Store checks.

What the platform says

  • Apple: Required Reason APIs. Developer rule: apps must declare why they use UserDefaults, since shared defaults can leak information across apps.

Good uses and abuse

Legitimate uses

  • Compliance

Known abuse

  • None

Scores

ScoreValueMeaning
Sensitivity1 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

  • 2024-05, iPhone iOS 17.x: Reason required to ship

Sources

How well checked: Based on official documentation.

On this page