Info General

Missing theme-color — Customize the Browser Toolbar on Mobile

The theme-color meta tag customizes the browser toolbar color on mobile devices.

What is theme-color?

The theme-color meta tag tells mobile browsers what color to use for the browser toolbar (address bar area). It creates a more immersive, branded experience by extending your site's color scheme into the browser chrome.

Where it's visible

  • Chrome on Android — Colors the status bar and toolbar
  • Safari on iOS (15+) — Colors the toolbar area
  • Samsung Internet — Full toolbar theming
  • PWAs — Used as the window title bar color

Why should you add it?

  1. Brand consistency — Your brand color extends beyond the page
  2. Professional appearance — The site feels more polished and app-like
  3. PWA requirement — Essential for Progressive Web Apps
  4. User experience — Creates a more immersive browsing experience

How to fix it

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

Support dark mode

<!-- Light mode -->
<meta name="theme-color" content="#ffffff" media="(prefers-color-scheme: light)" />

<!-- Dark mode -->
<meta name="theme-color" content="#1a1a2e" media="(prefers-color-scheme: dark)" />

Best practices

  1. Match your header/navbar color — The theme-color should blend with your site's top area
  2. Use your brand color — A recognizable color reinforces brand identity
  3. Support dark mode — Provide different colors for light and dark schemes
  4. Use hex values — Most reliable format across browsers
  5. Also set in manifest.json — For PWA installations

Related articles