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

Table of Contents

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:

  • name
  • state
  • last-changed
  • last-updated
  • none
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.
Primary and secondary information is now available in every Mushroom card, as shown in the Light Card
Various light cards created with Mushroom for Home Assistant
Due to the improvements in Mushroom v2.0.0, you can give each light an individual look

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

A screenshot showing an error in the configuration of a Mushroom Light Card for the Home Assistant Dashboard.
If you use hide_state in your configuration, Mushroom will show an error and you can’t use the visual editor
Removing the hide_state line allows you to use the visual editor

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:

  • icon
  • entity-picture
  • none

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

Liam Alexander Colman, the author and maintainer of Home Assistant Guides.

About Liam Alexander Colman

Liam Alexander Colman has been using Home Assistant for various projects for quite some time. What started off with a Raspberry Pi quickly became three Raspberry Pis and eventually a full-blown server. I now use Unraid as my operating system, and Home Assistant happily runs in a Docker container. My personal setup includes many Zigbee devices as well as integrations with existing products such as my Android TV box. Read on to find out more on how I got started with Home Assistant.

Leave a comment

Share to...