Required Reason: active keyboards
iOS reading active input modes needs 3EC4.1 or 54BD.1.
In one line
Can list your keyboards on iPhone only for approved reasons; Android lists them freely
iOS reading active input modes needs 3EC4.1 or 54BD.1.
Keyboard lists show languages and third-party keyboards. 3EC4.1 is for keyboard apps, 54BD.1 adjusts UI to active keyboards; neither may leave the device.
What it can and can't do
What the user does: Nothing. It happens when the app checks your keyboard setup
It can
- Check the keyboards and input languages that are turned on
- Adjust the app's layout when a keyboard changes (iPhone reason 54BD.1)
- Detect its own keyboard on iPhone (custom keyboard apps only)
- List keyboards on Android with no gate
It cannot
- Use the list on iPhone without a declared reason in the App Store listing
- Send the list off the phone on iPhone for tracking
- See what you type from the list alone
- Pass App Review on iPhone for a reason it does not meet
How it differs between platforms: iPhone requires a declared reason (3EC4.1 or 54BD.1) and rejects other uses. Android has no gate.
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: fingerprinting banned |
| Store policy | None listed | None listed |
| API | Android has no gate: getEnabledInputMethodList is open | 3EC4.1 custom keyboard apps only; 54BD.1 UI adjusts observably to keyboards; no off-device send |
| 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 | 2 values | exact |
Technical limits
- No off-device use
The story
What it is
Apple makes apps give a reason before they list your active keyboards and languages.
For you
You never see this. It is a rule between Apple and the app maker. An app that lists your keyboards must say why, and Apple can reject it if the reason does not fit.
For makers
Makers of keyboard apps have an approved reason to read active keyboards, as do apps that adjust their layout. The rule means the answer cannot be used for tracking or ads. Apps that break it risk rejection.
Where you see it
| Type | Example | Apps |
|---|---|---|
| utilities | A keyboard app checks which keyboards are on so it can show a setup hint if its own is off. | Gboard, SwiftKey |
| messaging | A chat app adjusts the input bar for a right to left language keyboard. | |
| education | A language learning app shows the right character set for the keyboard you use. | Duolingo |
| accessibility | An accessibility app changes its layout for a custom input method. | None named |
| analytics | An ad SDK would like to read the list to guess your language and country, which the rule bans. | None named |
| developer | A developer must add a reason code to the app's privacy manifest before shipping. | None named |
Risks
- Rule can be misused
- Hard for users to see
Android and iPhone in short
- Android: Android has no matching rule. Apps can read the list of enabled keyboards with fewer limits.
- iPhone: This is an Apple only rule that came in with privacy manifests for apps.
What the platform says
- Apple: Required Reason APIs. Apple asks developers to declare approved reasons when they use certain system APIs that could be used to fingerprint users.
Good uses and abuse
Legitimate uses
- Keyboard apps
Known abuse
- Language profiling
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
- Active keyboards and input languages. Can see which keyboards and input languages you turned on
Same idea on the web
- Keyboard layout map. Can tell your keyboard layout, such as QWERTY, AZERTY or QWERTZ
Sources
How well checked: Checked against real behavior.