I'm excited to announce a major update to the Template Card, bringing enhanced functionality, improved accessibility, and a completely redesigned editor.
Here’s what’s new:
- Accessibility support – The Template Card can now be fully controlled using a keyboard, making it easier to navigate and interact with.
- Full compatibility with card features – The card now works seamlessly with all standard card features used in Tile card.
- Icon Interaction Support – Just like the Tile card, icons now support multiple actions, including tap, hold, and double tap, for a more interactive experience.
- Redesigned editor – The card editor has been completely overhauled for a smoother and more intuitive design experience.
- Badge enhancements – Badges now support text display, allowing more informative and customizable indicators.
- Automatic migration – Existing Template Cards are automatically migrated to the new version, ensuring a seamless update with no extra work.
This update brings more flexibility, accessibility, and interactivity to the Template Card, making it more powerful and user-friendly than ever.
Breaking changes
🎨 Style and behavior breaking changes
The template card style is now aligned with the Tile card.
- Mushroom theme variables and colors are no longer applied, since the card now uses the same components and styles as the Tile card.
- Icons will only display a background when an action is assigned to them, making it clearer when they are interactive (https://www.home-assistant.io/blog/2025/03/05/release-20253/#making-tile-card-interactions-clearer).
- The default action is now
more-infoinstead oftoggleif you set an entity on the card. - The icon with have
toggleas default tap action if the entity supports toggle.
🛠️ Breaking Changes for Card Mod Users
Due to the Template Card redesign, its internal structure has changed. This will break existing Card Mod customizations.
👀 Backward compatibility
A Legacy Template Card is available to preserve the old behavior and style :
- the UI editor will allow you to revert to legacy card in one click
- in
yaml, you only have to replacecustom:mushroom-template-cardbycustom:mushroom-legacy-template-card
Changelog
New Features 🎉
- Template card redesign by @piitaya in #1755
- Add support for weather icon in template card by @piitaya in #1758
Fixes 🐛
- Fix default behavior for the template card by @piitaya in #1757
- Fix icon border radius for weather icon by @piitaya in #1773
Translations 🌍
- Update sv.json by @devasmith in #1742
- Translations update from Hosted Weblate by @weblate in #1738
- Translations update from Hosted Weblate by @weblate in #1751
- Translations update from Hosted Weblate by @weblate in #1759
- Translations update from Hosted Weblate by @weblate in #1772
Other Changes
- Update template.md with theming information by @piitaya in #1764
- Add theming section and compatibility information by @piitaya in #1763
New Contributors
- @devasmith made their first contribution in #1742
Full Changelog: v4.5.0...v5.0.5