Skip to Content
Platform.Ontology

App icon badge count

Shows an unread number on the app icon.

Works without askingNotifications and backgroundPermission and presentationAndroid and iPhoneIn the background

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

AndroidiPhone
StatusPartialSupported
First versionAndroid 8.0 (API 26)iOS 1.0
Permission or entitlementNot listedUNAuthorizationOptions.badge
Protection levelnoneprompt
How access is grantednoneprompt
What the user seesLauncher dot or count from notificationsBadges toggle in the permission prompt
How long it lastsDisappears when notifications are clearedUntil cleared or revoked
How to take it backSettings > Notifications > Allow notification dotSettings > Notifications > Badges
Store policyNone listedApp Review 4.5.4: no numbers for ads
APINotificationChannel.setShowBadge(), Notification.setNumber()UNUserNotificationCenter.setBadgeCount (iOS 16)
NotesVendor extensions (Samsung, Xiaomi) differsetBadgeCount replaced applicationIconBadgeNumber

Data you get

What comes back: Badge number
Shape: integer
How often: Server or app set

FieldTypeUnitRangePrecision
countintegerNone0 to a large integerexact

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

TypeExampleApps
messagingYour chat app shows 12 on the icon so you see how many messages you missed.WhatsApp, Slack
socialA social app shows a count of likes and follows to pull you back.Instagram, Facebook
productivityAn email app shows unread messages so you can triage from the home screen.Gmail, Outlook
shoppingA shopping app shows a dot when a wishlist item goes on sale.Amazon
gamesA game shows a badge when a free daily gift is ready to collect.Pokemon GO, Candy Crush
adsA growth team tests badge counts to see what brings back lapsed users.None named
bankingA 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

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility2 of 5How useful it is to honest apps
Friction2 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2022-09, iPhone iOS 16: setBadgeCount(_:) added; applicationIconBadgeNumber deprecated
  • 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.

On this page