Skip to content

0.62.0 - Dynamic Entity Badges and Area configured sensors are used! 🦡 📛

Choose a tag to compare

@github-actions github-actions released this 19 Jan 21:37

🎯 New Feature: Entity Badges

We're excited to introduce badges - small overlay icons that appear on entity icons to provide additional visual information at a glance!

badges

What are Badges?

Badges are small icons positioned at the corners of entity icons that can display:

  • Entity state information
  • Related entity data (e.g., show temperature sensor on a light icon)
  • Custom icons based on entity states or attributes
  • Native Home Assistant badges for supported domains (climate, person, device_tracker, humidifier)

Key Features

Up to 4 badges per entity - Position badges at any corner (top_right, top_left, bottom_right, bottom_left)

🎨 Multiple display modes:

  • show_always - Always visible, shows entity state
  • if_active - Only shows when entity is active
  • homeassistant - Uses native HA badge rendering for climate, person, device_tracker, and humidifier entities
  • State-based - Custom icons and colors based on entity states/attributes

🔗 Related entity support - Display information from a different entity on your main entity icon

Quick Example

type: custom:room-summary-card
area: living_room
entities:
  - entity_id: light.living_room
    badges:
      - position: top_right
        mode: show_always
      - position: top_left
        entity_id: sensor.living_room_temperature
        mode: show_always
  - entity_id: climate.living_room
    badges:
      - position: top_right
        mode: homeassistant

Use Cases

  • Show HVAC action badges on climate entities
  • Display related sensor data (temperature, humidity) on main entity icons
  • Indicate playback state on media players
  • Show person/device tracker status badges
  • Display custom state indicators with your own icons and colors

Documentation

For complete configuration options and examples, see the Badge Configuration documentation.

✨ Improvements

Area Default Sensor Support

The card now respects Home Assistant's area default sensor configuration. When an area has temperature_entity_id or humidity_entity_id configured in its area settings, the card will:

  • Use the configured default sensors instead of automatically collecting all sensors of that device class
  • Prevent duplicate sensors by skipping other temperature/humidity sensors when area defaults are set
  • Maintain consistency with Home Assistant's area card behavior

This ensures that when you've explicitly configured default temperature or humidity sensors for an area in Home Assistant, the card respects that choice and uses those specific sensors rather than averaging all sensors of that type.

Example:

If your area "shed" has:

  • temperature_entity_id: sensor.shed_climate_air_temperature
  • humidity_entity_id: sensor.shed_climate_humidity

Area Sensors

The card will use these specific sensors for temperature and humidity averaging, ignoring other temperature/humidity sensors in the area.

🐛 Bugfixes

  • View theme support: The card now correctly honors a view's theme (when set via hui-view-container), even if it differs from the main Home Assistant theme. This ensures theme-specific features like Frosted Glass detection work correctly when different views use different themes.

What's Changed

  • chore: yarn (deps-dev): bump @trivago/prettier-plugin-sort-imports from 6.0.1 to 6.0.2 in the all-dependencies group by @dependabot[bot] in #369
  • chore: yarn (deps-dev): bump prettier from 3.7.4 to 3.8.0 in the all-dependencies group by @dependabot[bot] in #374
  • Dynamic Entity Badges and Area configured sensors are used! 🦡 📛 by @warmfire540 in #375

Full Changelog: 0.61.0...0.62.0