Skip to Content
Platform.Ontology

Change tab title and icon

Changes the tab title and icon at any time, including while the tab is in the background.

Does something on your deviceThings a page can doAttentionWeb browsersWhile you use it

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

BrowserStatusFirst versionReleasedNote
ChromeSupported12008-12-11None
EdgeSupported122015-07-29None
FirefoxSupported12004-11-09None
SafariSupported42009-06-08None
Safari on iPhoneSupported3.22010-04-03All iOS browsers use WebKit
Chrome on AndroidSupported182012-06-27None
Samsung InternetSupported1.02013-04-27None

How a site asks for it

APIdocument.title = ...; <link rel=icon>; navigator.setAppBadge()
Browser compat keysapi.Document.title
api.Navigator.setAppBadge
How access is grantednone
What the user seesNone (no browser prompt)
Needs a secure context (HTTPS)No
Needs a user gestureNo
Activationnone
How long it lastsUntil navigation
How to take it backNothing to revoke (no permission is stored)
Inside an iframeFrames cannot change the top document title

Typical flow

  1. Script sets document.title or the icon href
  2. Tab strip updates
  3. 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

TypeExampleApps
messagingYour mail tab shows an unread count and flashes when a new email arrives.Gmail, Slack
liveA live auction tab shows 'Outbid!' in its title so you notice.eBay
gamesA browser strategy game flashes 'Your turn' in the tab title.Chess.com
videoA video call shows who is speaking in the tab icon.Google Meet
adsA shady site changes its title and icon to look like a bank or a warning.None named
productivityA 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

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

History

  • 2020-03, Chrome 81: Badging API for installed PWAs on desktop
  • 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.

On this page