Entity Card

The Entity card gives you a quick overview of your entity’s state.

Screenshot of the entity card Screenshot of the Entity card.

To add the Entity card to your user interface, click the menu (three dots at the top right of the screen) and then Edit Dashboard. Click the Add Card button in the bottom right corner and select from the card picker.

All options for this card can be configured via the user interface.

YAML Configuration

The following YAML options are available when you use YAML mode or just prefer to use YAML in the Code Editor in the UI.

Configuration Variables

type string Required


entity string Required

Entity ID.

name string (Optional, default: Entity name.)

Name of entity.

icon string (Optional)

Overwrites icon.

state_color boolean (Optional, default: false)

Set to true to have icon colored when entity is active.

attribute string (Optional)

An attribute associated with the entity.

unit string (Optional)

Unit of measurement given to data.


Unit of measurement given by entity.

theme string (Optional)

Override the used theme for this card with any loaded theme. For more information about themes, see the frontend documentation.

footer map (Optional)

Footer widget to render. See footer documentation.


- type: entity
  entity: cover.kitchen_window
- type: entity
  entity: light.bedroom
  attribute: brightness
  unit: "%"
- type: entity
  entity: vacuum.downstairs
  name: Vacuum
  icon: "mdi:battery"
  attribute: battery_level
  unit: "%"