mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-05 01:36:49 +00:00
6c6268a08e
Co-authored-by: Franck Nijhof <frenck@frenck.nl> Co-authored-by: Franck Nijhof <git@frenck.dev> fixes undefined
81 lines
2.1 KiB
Markdown
81 lines
2.1 KiB
Markdown
---
|
|
type: card
|
|
title: "Entity Card"
|
|
sidebar_label: Entity
|
|
description: "The Entity card gives you a quick overview of your entity's state"
|
|
---
|
|
|
|
The Entity card gives you a quick overview of your entity's state.
|
|
|
|
<p class='img'>
|
|
<img src='/images/dashboards/entity_card.png' alt='Screenshot of the entity card'>
|
|
Screenshot of the Entity card.
|
|
</p>
|
|
|
|
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 %}
|
|
type:
|
|
required: true
|
|
description: "`entity`"
|
|
type: string
|
|
entity:
|
|
required: true
|
|
description: Entity ID.
|
|
type: string
|
|
name:
|
|
required: false
|
|
description: Name of entity.
|
|
type: string
|
|
default: Entity name.
|
|
icon:
|
|
required: false
|
|
description: Overwrites icon.
|
|
type: string
|
|
state_color:
|
|
required: false
|
|
description: Set to `true` to have icon colored when entity is active.
|
|
type: boolean
|
|
default: false
|
|
attribute:
|
|
required: false
|
|
description: An attribute associated with the `entity`.
|
|
type: string
|
|
unit:
|
|
required: false
|
|
description: Unit of measurement given to data.
|
|
type: string
|
|
default: Unit of measurement given by entity.
|
|
theme:
|
|
required: false
|
|
description: Override the used theme for this card with any loaded theme. For more information about themes, see the [frontend documentation](/integrations/frontend/).
|
|
type: string
|
|
footer:
|
|
required: false
|
|
description: Footer widget to render. See [footer documentation](/dashboards/header-footer/).
|
|
type: map
|
|
{% endconfiguration %}
|
|
|
|
### Example
|
|
|
|
```yaml
|
|
- 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: "%"
|
|
```
|