With the latest release, the Mushroom Template Card has been redesigned to align with the official Home Assistant Tile Card.
This is a breaking change, and if you are using Card Mod or relying on old theme variables, you may need to adapt your setup.

But don’t worry, this post explains the changes, why they were made, and how to fix issues quickly.

🎨 Style and behavior Changes

• The Template Card now uses the same components and styles as the Tile Card.
• Mushroom theme variables and colors are no longer applied.
• Icons now only show a background when an action is assigned, making interactivity clearer (details in 2025.3 release notes).
• Default actions:
  • When an entity is set → more-info is now the default action (instead of toggle).
  • For the icon → the default tap action is `toggle* if the entity supports it.

🛠️ Breaking changes for Card Mod styles

Because of the redesign, the internal structure of the Template Card has changed.
This means existing Card Mod customizations will break and will need to be updated.

❓ FAQ: How to fix issues

Q: My Card Mod styles don’t work anymore!

Don't forget that there is not t card mod support here (see this post).

• Inspect the new Template Card structure with your browser’s developer tools.
• Update your Card Mod selectors to match the new DOM and classes.
• You can still use the old template card (it is not planned to remove it)
• If you need help from community, use the forum (here and here)
• This post is locked because it is not here to provide support. For card mod support, check the forum.

Q: I don’t like the new design, what can I do?
You have several options:

1. Use the Legacy Template Card

   • In YAML, replace:

     custom:mushroom-template-card

     with:

     custom:mushroom-legacy-template-card

   • Or, in the UI editor, click the Revert button (if supported).

2. Stay on an older version

   • You can keep using Mushroom v4.5.0 if you’re not ready to migrate.
   • There’s no obligation to update on day one.

📖 Background: why this change?

I created Mushroom 3 years ago because Home Assistant didn’t yet offer good dashboard options. At the time, Mushroom filled that gap.

But today, things have changed:

• We now have the Tile Card, Sections, the Heading Card… and they cover most of what Mushroom originally offered.
• A few months ago, I asked on Reddit why people still used Mushroom. The top answers were:
  • Template Card
  • Horizontal Mode

I’ve since added Horizontal Mode to the Tile Card. That leaves the Template Card as the main unique feature of Mushroom.

Instead of maintaining a parallel ecosystem, I’ve decided to:

• Make Mushroom a complement to official Home Assistant cards, rather than a duplicate.
• Gradually deprecate many Mushroom cards (entity, humidifier, climate, light, etc.) in favor of the Tile Card with equivalent features.
• Provide migration paths and custom extensions to extend both the Tile Card and the Template Card.

Maintaining Mushroom as a full duplicate was taking too much time. This change allows me to focus on what really matters: adding value on top of what Home Assistant already offers.

In short:

• The Template Card has been redesigned to match the official Tile Card.
• Some Card Mod setups will break, but you can either update them, use the Legacy Template Card, or stay on an older version.
• Mushroom’s future will focus on extensions and complements, not duplication.