---
title: "theme-color · Meta Tag · zhead"
canonical_url: "https://zhead.dev/meta/theme-color"
last_updated: "2026-08-19T02:35:56.149Z"
meta:
  description: "Suggests a color that browsers may use around the page, such as a title bar, tab highlight, or task switcher card."
  "og:description": "Suggests a color that browsers may use around the page, such as a title bar, tab highlight, or task switcher card."
  "og:title": "theme-color · Meta Tag · 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

- [HTML Living Standard: Semantics](https://html.spec.whatwg.org/multipage/semantics.html#meta-theme-color)

## Related meta tags

### [application-name](https://zhead.dev/meta/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](https://zhead.dev/meta/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](https://zhead.dev/meta/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](https://zhead.dev/meta/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](https://zhead.dev/meta/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.