1. Web
  2. HTML
  3. Reference
  4. Elements
  5. <meta>
  6. <meta> name
  7. theme-color

<meta name="theme-color">

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The theme-color value for the name attribute of the <meta> element indicates a suggested color that user agents should use to customize the display of the page or of the surrounding user interface. If specified, you define a theme color using a content attribute in the <meta> element as a CSS <color> value.

For example, to indicate that a document should use cornflowerblue as a theme color, set the <meta> as:

html
<meta name="theme-color" content="cornflowerblue" />

To set the media to which the theme color metadata applies, include the media attribute with a valid media query list (see the theme-color media query example).

Usage notes

A <meta name="theme-color"> element has the following additional attributes:

content

A <meta> element with name=theme-color must have a content attribute that defines the theme color. The value of content attribute is as follows:

<color> value

A valid color value, such as hexadecimal, RGB, named color, etc.

media Optional

Any valid media type or query. If provided, the options for the document's theme color defined in the content attribute are suggested to the browser when the media query matches.

Examples

Setting a color value

Consider the following code that uses <meta> to set a theme color:

html
<meta name="theme-color" content="#4285f4" />

The following image shows the effect of this setting in Chrome on an Android mobile device:

Image showing the effect of using theme-color

Image credit: from Icons & Browser Colors, created and shared by Google and used according to terms described in the Creative Commons 4.0 Attribution License.

Using a media query with theme-color

You can provide a media type or query inside the media attribute. The theme-color will then only be set if the media condition is true. For example:

html
<meta
  name="theme-color"
  content="cornflowerblue"
  media="(prefers-color-scheme: light)" />
<meta
  name="theme-color"
  content="dimgray"
  media="(prefers-color-scheme: dark)" />

Specifications

Specification
HTML
# meta-theme-color

Browser compatibility

See also

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

View this page on GitHub • Report a problem with this content