Heading card
The Heading card structures your dashboard by providing title, icon and navigation. This card supports actions.
Screenshot of heading cards with entity badges and a button badge.
type: heading
heading: Kitchen
icon: mdi:fridge
badges:
- type: entity
entity: sensor.kitchen_temperature
- type: entity
entity: sensor.kitchen_humidity
Configuration Variables
Style of the heading. Can be either title or subtitle.
Action taken on card tap. See action documentation. By default, it will do nothing. If an action is configured, a chevron will appear next to the heading text.
Additional small badges to display entity information. See heading badges.
Heading badges
In addition to the heading text, each heading card can show small badges. They are smaller than regular badges and don’t have a background. The heading badges can display sensor information or action buttons in a compact and minimal style. Heading badges also support actions.
The following badge types are available for heading cards:
Entity badge
The Entity badge allows you to display the state of an entity in the heading card.
type: entity
entity: light.living_room
Configuration Variables
Overwrites the entity name. The name will be only displayed if state_content includes name token.
Set the color when the entity is active. By default, it will not be colored. It can be set to the state special token to dynamically color the icon based on state, domain, and device_class of your entity. It also accepts color token or hex color code.
Content to display for the state. Can be state, name, last_changed, last_updated, or any attribute of the entity. Can be either a string with a single item, or a list of string items. Default depends on the entity domain.
Action taken on card tap. See action documentation. By default, it will do nothing.
Action taken on card hold. See action documentation. By default, it will do nothing.
Action taken on card double tap. See action documentation. By default, it will do nothing.
Button badge
The Button badge allows you to display a customizable button with an icon and/or text. This is useful for quick actions like turning off lights, triggering automations, or opening dashboards.
type: button
icon: mdi:lightbulb-off
text: Turn off lights
color: yellow
You can also create icon-only buttons or text-only buttons:
badges:
- type: button
icon: mdi:play
color: green
- type: button
text: Run automation
color: blue
Configuration Variables
Color of the badge. It accepts color token or hex color code.
Action taken on card tap. See action documentation. By default, it will do nothing.
Action taken on card hold. See action documentation. By default, it will do nothing.
Action taken on card double tap. See action documentation. By default, it will do nothing.