<zhead>
Meta tags

theme-color

Suggests a color that browsers may use around the page, such as a title bar, tab highlight, or task switcher card.

Code examples

Good example
<meta name="theme-color" content="#0d6efd">
A valid CSS hex color that browsers can use around the page.
Good example
<meta name="theme-color" content="blue">
Named CSS colors are valid values, though a precise brand color is usually more useful.
Avoid this example
<meta name="theme-color" content="#">
An incomplete hex color is invalid and will be ignored.
Avoid this example
<meta name="theme-color" content="brand-blue">
A design token name is not a CSS color value.

Recommendations

  • 01
    Use a Valid CSS Color
    The content can use any supported CSS color syntax, including named colors. Browsers ignore values they cannot parse.
  • 02
    Match Light and Dark Themes
    Add separate theme-color tags with unique media queries when the surrounding browser color should change with the page theme.
  • 03
    Treat It as a Suggestion
    Support and placement vary by browser. Check the result on the browsers your audience uses.

Related documentation

Related meta tags

application-name

name

Gives browsers a short name for the web application represented by the page. A browser may use it instead of the page title in bookmarks or other interface labels.

<meta name="application-name" content="Zhead">
A short application name that stays useful when the page title changes.

charset

charset

Declares the character encoding used by the HTML document. In modern HTML, the value must be UTF-8.

<meta charset="utf-8">
The required character encoding for modern HTML.

color-scheme

name

Tells the browser which color schemes the page can render. The browser can use this early, before the stylesheet loads, to choose a suitable canvas and native controls.

<meta name="color-scheme" content="light dark">
Declares support for both common schemes, with light listed first as the fallback preference.

default-style

http-equiv

Selects the preferred CSS style sheet set by name when a page offers alternate titled stylesheets. Browser support is limited.

<meta http-equiv="default-style" content="Main Style">
Valid when a linked stylesheet set has the exact title Main Style.

format-detection

name

An Apple extension that can stop Safari on iOS from turning text that looks like a telephone number into a call link.

<meta name="format-detection" content="telephone=no">
The value documented by Apple for disabling automatic telephone links in Safari on iOS.