Skip to Content
Platform.Ontology

Required Reason: active keyboards

iOS reading active input modes needs 3EC4.1 or 54BD.1.

Works without askingTyping and clipboardPrivacy manifestsAndroid and iPhoneWhen the app opensWhile you use it

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

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: fingerprinting banned
Store policyNone listedNone listed
APIAndroid has no gate: getEnabledInputMethodList is open3EC4.1 custom keyboard apps only; 54BD.1 UI adjusts observably to keyboards; no off-device send
NotesAndroid analog: no reason neededNone

Data you get

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

FieldTypeUnitRangePrecision
reason_codeslistcode2 valuesexact

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

TypeExampleApps
utilitiesA keyboard app checks which keyboards are on so it can show a setup hint if its own is off.Gboard, SwiftKey
messagingA chat app adjusts the input bar for a right to left language keyboard.WhatsApp
educationA language learning app shows the right character set for the keyboard you use.Duolingo
accessibilityAn accessibility app changes its layout for a custom input method.None named
analyticsAn ad SDK would like to read the list to guess your language and country, which the rule bans.None named
developerA 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

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

Same idea on the web

Sources

How well checked: Checked against real behavior.

On this page