Change tab title and icon
Changes the tab title and icon at any time, including while the tab is in the background.
In one line
Can change its tab name and small icon at any time
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
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 1 | 2008-12-11 | None |
| Edge | Supported | 12 | 2015-07-29 | None |
| Firefox | Supported | 1 | 2004-11-09 | None |
| Safari | Supported | 4 | 2009-06-08 | None |
| Safari on iPhone | Supported | 3.2 | 2010-04-03 | All iOS browsers use WebKit |
| Chrome on Android | Supported | 18 | 2012-06-27 | None |
| Samsung Internet | Supported | 1.0 | 2013-04-27 | None |
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.