Skip to Content
Platform.Ontology

Theme color for browser UI

Tints the browser's address bar or tab strip with a color the page picks.

Does something on your deviceScreen and windowsBrowser chromeWeb browsersWhile you use it

In one line

Can tint your browser's address bar or tab strip with a color it picks

Tints the browser's address bar or tab strip with a color the page picks.

A site can suggest a colour for the browser toolbar to match its brand. The tag is write only: it reveals nothing about the person, and the browser may ignore it.

What it can and can't do

What the user does: Nothing. It happens when the page loads.

It can

  • Set the color of the address bar or tab strip
  • Pick a different color for dark mode
  • Match the page's look

It cannot

  • Change the browser's buttons, menus or other parts
  • See anything about you
  • Set a color in Firefox, which ignores it

How it differs between platforms: Firefox ignores it. Chrome on computers only shows it in some window styles.

Browser support

BrowserStatusFirst versionReleasedNote
ChromePartial732019-03-12Desktop: installed PWAs only
EdgePartial792020-01-15Partial implementation per MDN BCD
FirefoxNot supportedNot availableNot listedNone
SafariSupported152021-09-20From Safari 26, installed web apps only
Safari on iPhoneSupported152021-09-20All iOS browsers use WebKit
Chrome on AndroidSupported922021-07-20None
Samsung InternetSupported6.22017-10-26None

How a site asks for it

API<meta name="theme-color" content="#fff" media="(prefers-color-scheme: dark)">
Browser compat keyshtml.elements.meta.name.theme-color
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 lastsPer page; the browser re-reads it on navigation or when the tag changes
How to take it backNothing to revoke (no permission is stored)
Inside an iframeOnly the top-level page's tag is used; iframes cannot set it

Typical flow

  1. Page includes a theme-color meta tag
  2. Browser tints its toolbar on supported platforms

Data you get

Shape: none

No individual data fields. The signal is the access itself.

Technical limits

  • Chrome for Android (92) and Samsung Internet (6.2) tint the toolbar; Chrome Android skips it on devices with native dark mode unless the page is an installed app
  • Desktop Chrome (73) uses it only for installed PWA title bars
  • Safari 15 used it for the tab bar; from Safari 26 only installed web apps use it
  • Firefox desktop and Firefox for Android do not support it
  • A media attribute lets pages offer different colours for light and dark
  • The browser may ignore the colour for contrast or privacy

The story

What it is

A page picks a color to tint your browser's address bar or tab strip.

For you

You see your browser bar change to match the site, such as green for a banking site or black for dark mode. It looks like part of the page.

For makers

Makers use it for brand feel and to make web apps look native. It can also swap with dark mode. It is harmless, though a fake color can add to the look of a copycat site.

Where you see it

TypeExampleApps
socialA social site tints your phone address bar blue so it looks like its own app.None named
gamesA browser game turns the browser bar black to blend with its dark menu.None named
shoppingA store paints the bar in its brand color on every product page.None named
mediaA music site uses the album art color for the bar while a track plays.None named
productivityA note app changes its bar color when you switch to dark mode.None named
securityA copycat bank page paints the bar the same color as the real bank to feel trusted.None named
newsA news site uses a red bar during live coverage.None named

Risks

  • Lookalike scams
  • Cosmetic only

What the platform says

Good uses and abuse

Legitimate uses

  • Brand consistency
  • Installed web app polish

Known abuse

  • Mimicking system chrome colours to look trustworthy

Scores

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility2 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

  • 2019-03, Chrome 73: Desktop Chrome applies it only to installed PWAs
  • 2021-07, Chrome on Android 92: Chrome for Android actually applies the colour
  • 2021-09, Safari 15: Safari 15 uses theme-color for the tab bar on macOS and iOS

Sources

How well checked: Based on official documentation.

On this page