Bubble Card 3
v3.1.2
Warning
This version requires Home Assistant 2026.3 to work correctly, I will release a new version soon to add support for previous Home Assistant versions.
Hi everyone!
Bubble Card v3.1.2 is a release mainly focused on quality improvements and performance optimizations. This update is essential if you already moved to Home Assistant 2026.3, it also makes navigation to pop-ups much easier, and it finally introduces an icon rendering approach aligned with Home Assistant so Bubble Card now displays exactly the same native HA icons.
Huge thank you again for all the feedback, bug reports, and contributions. Your reports helped me track down and fix many edge cases in this release ❤️
Here’s the full changelog:
💡 New features and enhancements
-
Existing pop-up hash in navigation dropdown:
Existing pop-up hash values are now shown in the “Navigation path” dropdown. This also fixes the impossibility to add a hash since the Home Assistant 2026.2 update. #2232 #2203
-
Home Assistant icons:
Icons now match Home Assistant exactly in all cases (finally!). This means some of your icons might change after this update. #2123 #2142 (and more...) -
Calendar card started events filter:
Added an option to filter started events on calendar cards. PR #2227 by @wollew, thank you!
✔️ Bug fixes and improvements
-
HA 2026.3 dropdown compatibility:
Fixed dropdown issues introduced by the Home Assistant 2026.3 update. This change significantly improves dropdown menus, for example they are no longer cropped in pop-ups! #2236 -
Bubble Card Tools migration issues:
Module IDs are now correctly normalized when needed during Bubble Card Tools migration. If you had migration issues before, remove thebubble_cardfolder then reload the page. -
Duplicate hash warning:
A warning is now shown when a duplicated hash is detected while creating or editing a pop-up. -
Pop-up opening performance (again):
Added optimizations to pop-ups so they now open smoother on slower devices. -
Media series title fallback:
Addedmedia_series_titleas a fallback formedia_artist. PR #2240 by @shyndman, thank you! -
Icon cache for faster rendering:
Icons are now cached to improve rendering performance. -
Scrolling effect refactor:
Refactored the scrolling effect to make it more stable, reliable, and less CPU intensive. -
Media player picture refresh:
Fixed media player picture not updating automatically in some cases. #2136 -
Sub-button icon update:
Fixed a Bubble Card UI issue where sub-button icons were not updating in some cases. #2117
Bubble News 🍻
Over the past few years, I’ve been working on Bubble Card almost every day to make it the best it can be, and I still can’t believe how much it has grown in popularity. Watching the community getting this big and seeing so many people using my work has been incredibly rewarding ❤️
This is why I decided to create a Patreon as a way to offer something more for those who want to support me. A few days ago, I refreshed my Patreon with 3 new modules: Bubble Badges v2 (unlimited badges on any sub-button or the main icon), Bubble Weather (animated weather backgrounds with daily/hourly forecasts) and Bubble Neon (a dynamic theme that automatically assigns unique vibrant colors to each Bubble Card). The custom dropdown module is still there if you want full control over labels, icons, and actions on select cards and sub-buttons.
I’m also finally happy with my own dashboard (there is a short video of it in this Reddit post), built entirely with Bubble Card v3.1.0 and only new custom modules I've been working on for months! Like one that adds unique colors and styles to all cards, one for the weather, one for graphs, square cards, time... I’ll release more of these modules soon, with a detailed post on Patreon and a new YouTube video. I would love to know what you think!
Thank you so much for being part of this amazing community, your support always makes a huge difference! ❤️
I’ve been wanting to start my own YouTube channel for a while, focusing on tutorials around Home Assistant and Bubble Card, and I really hope you will enjoy my videos. Don’t hesitate to subscribe to help give my channel more visibility. Thank you in advance!
I want to highlight that on the GitHub page, in the Discussions section, you can share and discover some amazing YAML examples from the community. Go check it out! Some of the creations are absolutely incredible!
And if you are interested I've opened a Subreddit for Bubble Card where I post my progress on the project. Here it is:
Also, if you ever want to grab me a fresh beer, here are two easy ways 🍻

