Skip to content
šŸ”¹ Change the favicon of your Home Assistant instance
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.



Change the gui page title, favicon and app icons of your Home Assistant instance


Installation instructions

  • Copy the contents of custom_components/favicon/ to <your config dir>/custom_components/favicon/.

  • Get some icons

    There are some nice ones available here, and you can generate favicons from them using an online tool, such as this one.

  • Put your icons in e.g. <your config dir>/www/favicons/. Note that <your config dir>/www/ translates to /local/ for the Icon path. Note: If you created <your config dir>/www/ you need to restart Home Assistant once before any icons will be found.

About the icons

hass-favicon will scan the specified directory and automatically apply icons when found based on their filename. There are three types of icons, and it's important that you get the filenames correct.

  • favicon.ico - The icon which is displayed on the browser tab and in the bookmark menu
  • favicon-apple-<anything>.png - The icon which is displayed if you save your interface to the home screen of your iDevice.
  • favicon-<size>x<size>.png - Used by android devices. <size> indicates the icon size in pixels, e.g. favicon-1024x1024.png.

Method 1/2 Integration

  • Go to your Home Assistant configuration and to Integrations

  • Add a "Favicon" integration

  • Enter your wanted title and the path to your icons. E.g. Icon path: /local/favicons/

  • Press submit

  • Refresh the page. Make sure to clear the cacke of your browser to get the new icons.


Method 2/2 YAML configuration

  • Add the following to your configuration.yaml:
  title: My Home
  icon_path: /local/favicons/
  • Restart Home Assistant

  • Make sure to clear the cache of your browser to get the new icons.


  • title - The title to display at the top of the window or browser tab.

  • icon_path: - The path (frontend path) of the directory containing your icons.

it IS charging thankyouverymuch

Buy Me A Coffee

You canā€™t perform that action at this time.