Energy Breakdown Card

Examples

Copy-pastable configs for the most common setups.

Don't forget!

These are getting-started examples. Replace the entity ids with your own.

Minimal (bar)

The smallest possible config — just a list of entities, defaulting to a stacked bar.

yaml

type: custom:energy-breakdown-card
entities:
  - entity: sensor.solar_energy_today
  - entity: sensor.grid_energy_today
  - entity: sensor.battery_energy_today

Donut with right legend

yaml

type: custom:energy-breakdown-card
title: Energy Breakdown
chart_type: donut
legend_position: right
show_total: true
show_legend_percentage: true
entities:
  - entity: sensor.solar_energy_today
    name: Solar
    color: "var(--energy-solar-color)"
  - entity: sensor.grid_energy_today
    name: Grid
    color: "#488fc2"
  - entity: sensor.battery_energy_today
    name: Battery
    icon: mdi:home-battery

Top sources with “Other”

Use max_items + group_others to keep the chart readable when you have many low-magnitude sources.

yaml

type: custom:energy-breakdown-card
chart_type: donut
sort: true
max_items: 4
group_others: true
entities:
  - entity: sensor.solar_energy_today
  - entity: sensor.grid_energy_today
  - entity: sensor.battery_energy_today
  - entity: sensor.car_energy_today
  - entity: sensor.heatpump_energy_today
  - entity: sensor.dishwasher_energy_today
  - entity: sensor.dryer_energy_today

Sync to the energy dashboard period

With energy_date_selection: true, values follow the period selected on the energy dashboard (today, week, custom range, …) using statistics growth.

yaml

type: custom:energy-breakdown-card
chart_type: bar
energy_date_selection: true
entities:
  - entity: sensor.solar_energy
  - entity: sensor.grid_energy
  - entity: sensor.battery_energy

Multiple energy dashboards

When you maintain more than one Home Assistant energy dashboard, bind this card to a specific dashboard's collection. Keys follow the pattern energy_<dashboard_url>.

yaml

type: custom:energy-breakdown-card
energy_date_selection: true
collection_key: energy_living_room
entities:
  - entity: sensor.solar_energy
  - entity: sensor.grid_energy
  - entity: sensor.battery_energy

Mix & match (full config)

Demonstrates many of the available options at once. You don't need most of these — this is a reference of what is possible.

yaml

type: custom:energy-breakdown-card
title: Energy Breakdown
chart_type: bar
show_legend: true
show_tooltip: true
show_total: true
show_legend_value: true
show_legend_percentage: true
show_icons: true
sort: true
max_items: 5
group_others: true
decimals: 1
unit_of_measurement: kWh
bar_thickness: 22
section_radius: 11
energy_date_selection: true
entities:
  - entity: sensor.solar_energy_today
    name: Solar
    color: "var(--energy-solar-color)"
    icon: mdi:solar-power
    tap_action:
      action: more-info
  - entity: sensor.grid_energy_today
    name: Grid
    color: "var(--energy-grid-consumption-color)"
  - entity: sensor.battery_energy_today
    name: Battery
    icon: mdi:home-battery
  - entity: sensor.car_energy_today
    name: EV
    icon: mdi:car-electric
    color: "#80b8ff"
  - entity: sensor.heatpump_energy_today
    name: Heat pump
    icon: mdi:heat-pump