Skip to Content
Platform.Ontology

Dark mode and theme

Reads whether the system uses dark or light appearance.

Gets silentlyLanguage and settingsAppearanceAndroid and iPhoneWhen the app opensWhile you use it

In one line

Can see whether your phone is in dark or light mode

Reads whether the system uses dark or light appearance.

Weak habit signal; one bit, but often scheduled so it also hints at sunset time.

What it can and can't do

What the user does: Nothing. It happens when the app opens or you switch themes

It can

  • Check if the system uses dark or light appearance
  • Switch its own colors to match

It cannot

  • Change your phone's theme
  • See your wallpaper, brightness or schedule
  • Tell who you are on its own, but it is one bit in a fingerprint

On Android and iPhone

AndroidiPhone
StatusSupportedSupported
First versionAndroid 10 (API 29)iOS 13.0
Permission or entitlementNot listednone
Protection levelnonenone
How access is grantednonenone
What the user seesNot listedNot listed
How long it lastsNot listedNot listed
How to take it backNot listedNot listed
Store policyNone listedNone listed
APIConfiguration.uiMode (UI_MODE_NIGHT_MASK)light or dark
NotesBooleanNone

Data you get

What comes back: Dark mode on
Shape: boolean
How often: On change

FieldTypeUnitRangePrecision
nightbooleanNonetrue, false1 bit

Technical limits

  • Low entropy

The story

What it is

An app sees whether your phone is in dark or light appearance.

For you

You flip a switch or let the phone change at sunset, and apps follow. Your eyes thank you at night. You never see the apps read the setting.

For makers

Makers want apps to feel native and to save battery. The setting is a single bit, but it often follows a schedule, so it can hint at sunset time and where you are.

Where you see it

TypeExampleApps
mediaA video app turns its menus dark when you watch at night so the screen is easier to look at.Netflix, YouTube
gamesA game picks a darker menu theme when your phone is in dark mode.None named
messagingA chat app switches its bubbles to dark colors to match your phone.Telegram, Signal
newsA reading app follows dark mode so late night reading is calmer.Apple News
analyticsA tracker adds dark mode to a profile, which helps match the same phone across sites.None named
adsAn advertiser changes ad colors at night so ads blend in with the app.None named

Risks

  • Adds one fingerprint bit
  • Hints at schedule

Android and iPhone in short

  • Android: Android apps read it through the night mode setting, and many follow it automatically.
  • iPhone: iPhone apps read it from the user interface style, and may change when the schedule flips.

What the platform says

  • Apple: Dark Mode. Apple's system wide dark look that apps can follow so screens are easier on the eyes at night.
  • Google: Dark theme. Android lets apps follow a system dark theme, which can save battery on OLED screens.

Good uses and abuse

Legitimate uses

  • Match theme

Known abuse

  • Fingerprint bit

Scores

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility1 of 5How useful it is to honest apps
Friction0 of 5How much the user has to do
Fingerprint bits1Rough identifying entropy, when known

Same idea on the web

Sources

How well checked: Based on official documentation.

On this page