Mushroom for Home Assistant v2.0.0 is now broadly available

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.

Building on the customizability recently added to the Mushroom template card, Mushroom v2.0.0 allows you to create an even distincter Home Assistant Dashboard. Besides the benefits you will experience, this update also includes a major code refactoring, which should make future development easier and thus updates more frequent.

Primary and secondary information options for all Mushroom cards

Until now, only the Mushroom Entity Card was able to display secondary information alongside the primary information. In Mushroom v2.0.0, all cards get this option. Using a dropdown, you can easily select which information you want where. Currently, the following five options are available:

A screenshot of the configuration of a Mushroom Light Card in the Home Assistant Dashboard. It shows the following options: Entity, name, icon, layout, primary information, and secondary information.
Various light cards created with Mushroom for Home Assistant

These newly added options mean that the developer could deprecate two previously used options: hide_name and hide_state. Instead of these, you can simply select none from the dropdown. If you were a user of these options, your Dashboard luckily won't break after installing the update. The developer was kind enough to enable backwards compatibility.

What you will see, however, is a warning and no option to use the visual editor whenever you edit a card using the deprecated options. In my case, I was previously using the hide_state option, and by removing that line from the code, I was able to use the visual editor once again.

Add icons or pictures to any entity in Mushroom v2.0.0

Similarly to the primary and secondary information, the way you select icons or pictures has also slightly changed and been unified. You now have the option to select between:

In addition to these option, the template card now gives you the opportunity to not only use Material Design Icons (MDI), but also images. Whenever you select an image, be it from the web or one you have uploaded locally, the icon will automatically be disabled.

A screenshot of the configuration of a Mushroom Template Card, showing the following options: Badge icon, badge colour, and picture.

Less code means faster development

As hinted at in the introduction, this update is much more than what you see on the surface. Due to all cards sharing the appearance configuration, there is less duplicate code to take care of for the developer. What this means for us users is that future updates will have fewer lines of code to check before each update is released.

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...