Remove your Home Assistant Custom Header right now

Disclosure: This post contains affiliate links. If you click through and make a purchase, I will earn a commission, at no additional cost to you. Read my full disclosure here.

Abstract shapes

Once a cornerstone of dashboard personalization in the Home Assistant community, the Custom Header custom component offered unparalleled control over the appearance of the user's Dashboard. Initially a simple tool designed for minimalistic aesthetic adjustments, it evolved into an essential feature for many, especially those utilizing mobile devices or wall-mounted tablets. However, as time passed, the plugin transformed into a complex beast, burdened by its own ambition, leading to its eventual retirement. Despite its end, Custom Header's influence persists, inspiring ongoing development within the Home Assistant ecosystem.


Custom Header: A Journey from Convenience to Complexity

Custom Header stood out as a prominent option for those aspiring to customize their Home Assistant Dashboards beyond the default settings. Its ability to modify the Dashboard's header made it a favourite among users seeking a tailored smart home control panel. This adaptability was particularly valuable for setups involving mobile access or dedicated wall displays, where screen real estate is at a premium.

The Inevitable Sunset of Custom Header

The expansion of Custom Header from a straightforward tool to a comprehensive modification solution was both its greatest achievement and its undoing. As the community's desires for more sophisticated features grew, so did the complexity of the plugin. This escalation led to an unsustainable maintenance challenge, culminating in the developer describing it as a “bloated monstrosity” and an “absolute mess of code.” This candid acknowledgment signalled the end of Custom Header's development journey, marking a poignant moment for its users.

Despite its discontinuation, the spirit of Custom Header lives on. The original developer has shifted their focus towards contributing directly to Home Assistant, embedding the essence of Custom Header's functionality into the core platform. In addition, the project is free and anyone can use it. This makes it possible for new developers to continue working on it. It also gives a reason to hope that it can be revived in a new way.

The Future: Compact Headers and Beyond

The discontinuation of Custom Header doesn't spell the end for customizable compact headers within the Home Assistant Dashboard. On the contrary, it opens a new chapter where the developer's insights and expertise are funnelled directly into Home Assistant's evolution. This transition ensures that the user experience will continue to improve, maintaining the legacy of Custom Header's mission to enhance dashboard usability and aesthetics.

As we await the next Home Assistant release, which will render Custom Header adjustments obsolete, users are advised to remove the plugin to ensure a smooth transition. The commitment to integrating compact header functionality directly into Home Assistant signifies a promising future for dashboard customization, promising a seamless and engaging user experience.


In summary, while Custom Header's retirement marks the end of an era, it also heralds a new phase of innovation within the Home Assistant community. The plugin's legacy will continue to influence the platform's development, ensuring that personalization remains at the heart of the Home Assistant experience.

A portrait photo oif Liam Alexander Colman, the author, creator, and owner of Home Assistant Guide wearing a suit.

About Liam Alexander Colman

is an experienced Home Assistant user who has been utilizing the platform for a variety of projects over an extended period. His journey began with a Raspberry Pi, which quickly grew to three Raspberry Pis and eventually a full-fledged server. Liam's current operating system of choice is Unraid, with Home Assistant comfortably running in a Docker container.
With a deep understanding of the intricacies of Home Assistant, Liam has an impressive setup, consisting of various Zigbee devices, and seamless integrations with existing products such as his Android TV box. For those interested in learning more about Liam's experience with Home Assistant, he shares his insights on how he first started using the platform and his subsequent journey.

Leave a comment

Share to...