Required Reason: UserDefaults
iOS UserDefaults access needs a reason code such as CA92.1 (app only) or 1C8F.1 (app group).
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
| Android | iPhone | |
|---|---|---|
| Status | Not supported | Behind a flag |
| First version | Not available | iOS 17.0 |
| Permission or entitlement | none | entitlement |
| Protection level | none | entitlement |
| How access is granted | not-exposed | none |
| What the user sees | Not listed | Not listed |
| How long it lasts | Not listed | Not listed |
| How to take it back | Not listed | App Review: reason must match use |
| Store policy | None listed | None listed |
| API | Android has no gate: SharedPreferences is app-private | CA92.1 app-only; 1C8F.1 same app group; C56D.1 SDK wrapper only; AC6B.1 managed app config |
| Notes | Android analog: no reason needed | None |
Data you get
What comes back: Reason codes
Shape: object
How often: At upload
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
reason_codes | list | code | 4 values | exact |
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
| Type | Example | Apps |
|---|---|---|
| productivity | A notes app saves your theme choice and declares CA92.1. | None named |
| games | A game saves your sound setting and declares CA92.1. | None named |
| enterprise | A work app reads settings set by a company manager and declares AC6B.1. | None named |
| developer | An SDK wraps defaults for the app and declares C56D.1. | None named |
| media | A music app shares settings with its widget through an app group and declares 1C8F.1. | None named |
| ads | A 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
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 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
- 2024-05, iPhone iOS 17.x: Reason required to ship
Related capabilities
Related
- Required Reason APIs and privacy manifest. Can only use five fingerprint prone phone details with an approved reason on iPhone
Sources
How well checked: Based on official documentation.