Change tab title and icon
Changes the tab title and icon at any time, including while the tab is in the background.
A site can animate the title, add unread counts, or swap the favicon. It is a no-prompt way to draw attention from a hidden tab; scammers also use it to mimic other sites.
What it can and can't do
What the user does: Nothing. It happens as you use the page, even when the tab is hidden.
It can
- Change the tab name, such as to show a new message count
- Swap the small icon in the tab
- Change them even when you are in another tab
It cannot
- Change the title or icon of other sites or tabs
- Change what is in your bookmarks without you saving it
- Hide the real site address in the address bar
Browser support
Version notes
- Safari on iPhone: All iOS browsers use WebKit
How a site asks for it
| API | document.title = ...; <link rel=icon>; navigator.setAppBadge() |
| Browser compat keys | api.Document.titleapi.Navigator.setAppBadge |
| How access is granted | none |
| What the user sees | None (no browser prompt) |
| Needs a secure context (HTTPS) | No |
| Needs a user gesture | No |
| Activation | none |
| How long it lasts | Until navigation |
| How to take it back | Nothing to revoke (no permission is stored) |
| Inside an iframe | Frames cannot change the top document title |
Typical flow
- Script sets document.title or the icon href
- Tab strip updates
- App badge needs an installed PWA (Chrome desktop 81)
Data you get
Shape: none
No individual data fields. The signal is the access itself.
Technical limits
- No limit on title length in the DOM; tab strips truncate to about the first 20 to 40 characters
- Favicon cache may delay updates (Chrome, Safari cache aggressively)
- Badging API works only for installed apps in Chrome and Safari 17 Home Screen web apps; no prompt in installed apps for the numeric badge but notifications permission is needed on iOS
- Page cannot flash the taskbar or play a system sound without media or notification permission
The story
What it is
A page can change its tab name, icon and badge, even when you are looking elsewhere.
For you
Your tab shows '(3) Inbox' or blinks a dot when something new arrives. You feel pulled back to check it, even though you never asked for alerts.
For makers
Makers use it as a free attention nudge: unread counts, call status, game turns. It works without any permission, so it reaches everyone.
Where you see it
| Type | Example | Apps |
|---|---|---|
| messaging | Your mail tab shows an unread count and flashes when a new email arrives. | Gmail, Slack |
| live | A live auction tab shows 'Outbid!' in its title so you notice. | eBay |
| games | A browser strategy game flashes 'Your turn' in the tab title. | Chess.com |
| video | A video call shows who is speaking in the tab icon. | Google Meet |
| ads | A shady site changes its title and icon to look like a bank or a warning. | None named |
| productivity | A project tool shows a spinner icon while it saves. | Notion |
Risks
- Nagging
- Fake looking tabs
What the platform says
- Google: Badging API. Chrome's docs say the badging API lets an installed web app show a number on its icon.
Good uses and abuse
Legitimate uses
- Unread counts
- Status in tab
- Dark and light favicons
Known abuse
- Fake site favicon
- Tab title swap after the person leaves (tabnabbing)
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 3 of 5 | How useful it is to honest apps |
| Friction | 0 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2020-03, Chrome 81: Badging API for installed PWAs on desktop
Related capabilities
Related
- Badging API. Can show a number or dot on an installed app's icon, but can't check it
Sources
How well checked: Based on official documentation.