home-assistant.io/source/_dashboards/history-graph.markdown
Fergus McMenemie c126e1aa8f
Update history-graph.markdown (#27101)
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
2023-04-24 14:03:31 +02:00

2.6 KiB

type, title, sidebar_label, description
type title sidebar_label description
card History Graph Card History Graph The History Graph card allows you to display a graph for each of the entities listed.

The History Graph card allows you to display a graph for each of up to eight entities.

Screenshot of the history graph card for entities without a unit_of_measurement Screenshot of the History Graph card, when the sensor has no `unit_of_measurement` defined.

Screenshot of the history graph card for entities with a unit_of_measurement Screenshot of the History Graph card, when the sensor has a `unit_of_measurement` defined.

To add the History Graph 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: history-graph type: string entities: required: true description: "A list of entity IDs or entity objects, see below." type: list hours_to_show: required: false description: Hours to show in graph. Minimum is 1 hour. Big values can result in delayed rendering, especially if the selected entities have a lot of state changes. type: integer default: 24 title: required: false description: The card title. type: string show_names: required: false description: If false, no entity names are shown in the card. type: boolean default: true {% endconfiguration %}

Options For Entities

If you define entities as objects instead of strings, you can add more customization and configuration:

{% configuration %} entity: required: true description: Entity ID. type: string name: required: false description: Overwrites friendly name. type: string {% endconfiguration %}

Examples

type: history-graph
title: 'My Graph'
entities:
  - sensor.outside_temperature
  - entity: media_player.lounge_room
    name: Main player

Or with longer time frame, and multiple entities (as long as they share the same unit_of_measurement) in one graph:

type: history-graph
title: "Temperatures in the last 48 hours"
hours_to_show: 48
entities:
  - sensor.outside_temperature
  - entity: sensor.lounge_temperature
    name: "Lounge"
  - entity: sensor.attic_temperature
    name: "Attic"