Dashboards

Home Assistant Dashboard Themes: How to Install and Switch Them

Install and switch Home Assistant dashboard themes. Covers enabling the themes folder, YAML theme files, picking a theme per profile, and card-mod styling.

On this page
  1. Quick answer
  2. Before you start
  3. Step 1: Enable themes
  4. Step 2: Add a theme file
  5. Step 3: Reload and select
  6. Popular theme families
  7. Go further with card-mod
  8. Troubleshooting
  9. Related guides

Quick answer

Dashboard themes change the colours, transparency and visual styling of the Home Assistant interface. You enable them once in configuration.yaml, add theme files to a themes folder, and then choose a theme in your user profile. Themes don’t rearrange your cards; for layout changes, use views and cards instead.

Before you start

  • Get access to your config folder. You’ll edit configuration.yaml and add files in /config/. Use the file access method you already have, such as the Samba share, SSH or an editor add-on.
  • Pick a theme. Community themes are installed through HACS, where you can filter by the Theme type. You can also add a theme file by hand.

Step 1: Enable themes

Add a frontend block to configuration.yaml:

frontend:
  themes: !include_dir_merge_named themes

Create a folder named themes in your config folder, so the path is /config/themes/. Restart Home Assistant after you first add the frontend: block. After that, you can reload theme files without a restart using the frontend.reload_themes action.

Step 2: Add a theme file

Each theme is a YAML file inside /config/themes/. The file name is for your reference; the theme’s name is the top-level key inside the file. A theme is a set of CSS variables, so you set values such as primary-color and card-background-color:

midnight-blue:
  primary-color: "#4f8df7"
  card-background-color: "#1b2233"
  primary-background-color: "#0f1420"

Quote hex colours, as shown. In YAML, an unquoted # starts a comment, so the colour would be dropped.

Step 3: Reload and select

Run frontend.reload_themes from Developer tools, under Actions, or from an automation. Then open your profile, find the theme setting, and pick your theme. The choice applies to the browser or app where you make it, so a phone and a wall tablet can show different themes.

Community themes cover a wide range of looks. These are the groups people most often try:

  • Minimal and modern: Material You, Catppuccin (Latte, Frappé, Macchiato and Mocha), Slate, and Graphite, which suits e-ink screens.
  • Glass and mobile-style: Frosted Glass, VisionOS, and iOS-style themes with light and dark variants.
  • Retro and sci-fi: Pip-Boy terminal, LCARS, and similar themes.

Check each theme’s own documentation for its install steps and supported Home Assistant versions.

Go further with card-mod

Themes can’t style every card. For per-card changes, install the card-mod custom card through HACS and add a card_mod: section with CSS to the card’s YAML. Custom cards such as Mushroom and Bubble Card also change how cards look and are often paired with themes.

Some dashboard templates depend on card-mod, so check a template’s requirements before you import it.

Troubleshooting

  • The theme doesn’t appear. Check the YAML indentation and the file’s location, then run frontend.reload_themes. If you only just added the frontend: block, restart Home Assistant.
  • Colours look wrong on one device. The theme may be set in a different browser or app. Check the profile on that device.
  • Only part of the dashboard changes. Some cards set their own colours. Card-level settings or card-mod can override the theme.
  • A dashboard shows errors after import. Templates often need HACS custom cards. Install the cards the template lists, then reload the dashboard.

The complete guide to dashboards

Home Assistant Dashboards: Building a Beautiful Lovelace UI
Read the guide

Keep exploring

Guides from other topics

All topics →