App icon badge count
Shows an unread number on the app icon.
In one line
Can show a number on the app icon, if you allow badges
Shows an unread number on the app icon.
A constant nudge to re-open the app. iOS needs alert-style permission for badges; Android launchers derive badges from active notifications, not from a number the app can set.
What it can and can't do
What the user does: You allow notifications and the Badges switch when the app asks
It can
- Show a count of unread items on the icon
- Clear or change the count when you open the app
- Show a dot or count on the Android icon, depending on your launcher
It cannot
- Show a badge on iPhone if you turned Badges off
- Show exactly the same way on every Android launcher; Samsung and Xiaomi differ
- Tell the app anything about you; it only shows a number
How it differs between platforms: iPhone has a Badges toggle in the permission prompt. Android shows a dot or count that depends on the launcher.
On Android and iPhone
| Android | iPhone | |
|---|---|---|
| Status | Partial | Supported |
| First version | Android 8.0 (API 26) | iOS 1.0 |
| Permission or entitlement | Not listed | UNAuthorizationOptions.badge |
| Protection level | none | prompt |
| How access is granted | none | prompt |
| What the user sees | Launcher dot or count from notifications | Badges toggle in the permission prompt |
| How long it lasts | Disappears when notifications are cleared | Until cleared or revoked |
| How to take it back | Settings > Notifications > Allow notification dot | Settings > Notifications > Badges |
| Store policy | None listed | App Review 4.5.4: no numbers for ads |
| API | NotificationChannel.setShowBadge(), Notification.setNumber() | UNUserNotificationCenter.setBadgeCount (iOS 16) |
| Notes | Vendor extensions (Samsung, Xiaomi) differ | setBadgeCount replaced applicationIconBadgeNumber |
Data you get
What comes back: Badge number
Shape: integer
How often: Server or app set
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
count | integer | None | 0 to a large integer | exact |
Technical limits
- Cannot be set directly on stock Android
The story
What it is
The little red number on an app icon that shows unread items.
For you
You see a number or dot on the icon and feel the urge to clear it. It tells you something is waiting without a sound.
For makers
Makers know a red badge is one of the strongest nudges to reopen an app. It lifts daily use, so some apps are accused of making badges that never go away.
Where you see it
| Type | Example | Apps |
|---|---|---|
| messaging | Your chat app shows 12 on the icon so you see how many messages you missed. | WhatsApp, Slack |
| social | A social app shows a count of likes and follows to pull you back. | Instagram, Facebook |
| productivity | An email app shows unread messages so you can triage from the home screen. | Gmail, Outlook |
| shopping | A shopping app shows a dot when a wishlist item goes on sale. | Amazon |
| games | A game shows a badge when a free daily gift is ready to collect. | Pokemon GO, Candy Crush |
| ads | A growth team tests badge counts to see what brings back lapsed users. | None named |
| banking | A bank app shows a dot for a new statement or security notice. | None named |
Risks
- A nagging nudge
- Can pressure you to keep checking
Android and iPhone in short
- Android: Android launchers show a dot or count taken from active notifications, not a number the app sets.
- iPhone: iOS needs you to allow badges in the permission prompt.
What the platform says
- Apple: Badges. Apple lets apps show a number on the icon to tell you something new is waiting, if you allow it.
Good uses and abuse
Legitimate uses
- Unread count
Known abuse
- Dark pattern nagging
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 | 2 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2022-09, iPhone iOS 16: setBadgeCount(_:) added; applicationIconBadgeNumber deprecated
Related capabilities
Related
- Notifications. Can show alerts, banners and badges, but only after you allow it
Same idea on the web
- Badging API. Can show a number or dot on the icon of an installed web app
Sources
How well checked: Based on official documentation.