Dark mode and theme
Reads whether the system uses dark or light appearance.
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
| Android | iPhone | |
|---|---|---|
| Status | Supported | Supported |
| First version | Android 10 (API 29) | iOS 13.0 |
| Permission or entitlement | Not listed | none |
| Protection level | none | none |
| How access is granted | none | none |
| What the user sees | Not listed | Not listed |
| How long it lasts | Not listed | Not listed |
| How to take it back | Not listed | Not listed |
| Store policy | None listed | None listed |
| API | Configuration.uiMode (UI_MODE_NIGHT_MASK) | light or dark |
| Notes | Boolean | None |
Data you get
What comes back: Dark mode on
Shape: boolean
How often: On change
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
night | boolean | None | true, false | 1 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
| Type | Example | Apps |
|---|---|---|
| media | A video app turns its menus dark when you watch at night so the screen is easier to look at. | Netflix, YouTube |
| games | A game picks a darker menu theme when your phone is in dark mode. | None named |
| messaging | A chat app switches its bubbles to dark colors to match your phone. | Telegram, Signal |
| news | A reading app follows dark mode so late night reading is calmer. | Apple News |
| analytics | A tracker adds dark mode to a profile, which helps match the same phone across sites. | None named |
| ads | An 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
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 1 of 5 | How useful it is to honest apps |
| Friction | 0 of 5 | How much the user has to do |
| Fingerprint bits | 1 | Rough identifying entropy, when known |
Related capabilities
Same idea on the web
- prefers-color-scheme. Can tell whether your device theme is light or dark
Sources
How well checked: Based on official documentation.