Theme color for browser UI
Tints the browser's address bar or tab strip with a color the page picks.
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
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Partial | 73 | 2019-03-12 | Desktop: installed PWAs only |
| Edge | Partial | 79 | 2020-01-15 | Partial implementation per MDN BCD |
| Firefox | Not supported | Not available | Not listed | None |
| Safari | Supported | 15 | 2021-09-20 | From Safari 26, installed web apps only |
| Safari on iPhone | Supported | 15 | 2021-09-20 | All iOS browsers use WebKit |
| Chrome on Android | Supported | 92 | 2021-07-20 | None |
| Samsung Internet | Supported | 6.2 | 2017-10-26 | None |
How a site asks for it
| API | <meta name="theme-color" content="#fff" media="(prefers-color-scheme: dark)"> |
| Browser compat keys | html.elements.meta.name.theme-color |
| 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 | Per page; the browser re-reads it on navigation or when the tag changes |
| How to take it back | Nothing to revoke (no permission is stored) |
| Inside an iframe | Only the top-level page's tag is used; iframes cannot set it |
Typical flow
- Page includes a theme-color meta tag
- 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
| Type | Example | Apps |
|---|---|---|
| social | A social site tints your phone address bar blue so it looks like its own app. | None named |
| games | A browser game turns the browser bar black to blend with its dark menu. | None named |
| shopping | A store paints the bar in its brand color on every product page. | None named |
| media | A music site uses the album art color for the bar while a track plays. | None named |
| productivity | A note app changes its bar color when you switch to dark mode. | None named |
| security | A copycat bank page paints the bar the same color as the real bank to feel trusted. | None named |
| news | A news site uses a red bar during live coverage. | None named |
Risks
- Lookalike scams
- Cosmetic only
What the platform says
- MDN: theme-color meta tag. Documents the tag a page uses to suggest a color for the browser toolbar.
Good uses and abuse
Legitimate uses
- Brand consistency
- Installed web app polish
Known abuse
- Mimicking system chrome colours to look trustworthy
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 2 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
- 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
Related capabilities
Related
- Change tab title and icon. Can change its tab name and small icon at any time
- display-mode. Can tell whether it is open in a browser tab, a home screen app or fullscreen
Sources
How well checked: Based on official documentation.