EVCC Card for Home Assistant

June 24, 2026 · View on GitHub

A custom Lovelace card for Home Assistant that provides a comprehensive dashboard for EVCC - the open-source EV charging controller - using the ha-evcc integration.

All charge points and site entities are automatically discovered via the HA entity registry - no manual entity mapping required. Starting with v0.5.0, the card includes a native visual editor - just add the card and configure everything interactively.

Screenshots

Charge Point	Site	Flow	Grid

Statistics	Battery	Compact	Plan

Priority	Repeat plan

Features

Feature	Description
Auto-discovery	Automatically detects all charge points and site entities via the HA entity registry - zero configuration
Visual editor	Native card editor in Home Assistant - configure everything interactively, no YAML needed
Live updates	Power, SoC and status update in real time without full re-render
Responsive scaling	Card automatically scales to fit larger screens via CSS container queries; can be overridden with a fixed `size`
SoC display	Vehicle state of charge as a progress bar with percentage and estimated range
Slider controls	Adjust Target SoC, Min SoC, Priority, smart charging limit, feed-in priority limit, battery boost, Max current and Min current inline
Phase switching	Auto / 1-phase / 3-phase control built in
Plan strategies	Continuous charging and battery preconditioning settings inline in the plan block
Repeating plans	`repeatplan` mode lists evcc's weekly repeating charge plans per vehicle and toggles them on/off (ha-evcc 2026.6.1+)
Action indicators	Pending phase switches (1↔3 phase) and PV-charging start/stop shown as inline countdown chips
Diagnostics	Built-in `debug` mode collects card / HA / integration state into a copy-paste-ready bug report
Multi-language	Support for various languages - auto-detected from HA language setting, easily extensible

Prerequisites

Home Assistant (2023.x or newer)
ha-evcc integration installed and configured, with a running EVCC instance connected to it

Installation

Via HACS (recommended)

hass-evcc-card is part of the default HACS repository - no custom repository setup needed.

Open HACS in Home Assistant
Search for EVCC Card
Click Download
Reload your browser

Note for YAML mode users: If your Lovelace is configured with mode: yaml in configuration.yaml, HACS cannot register the resource automatically. Add the resource entry manually - see Manual resource registration below.

Manual installation

Download evcc-card.js and the locales/ folder from the latest release
Copy them to config/www/hass-evcc-card/ in your Home Assistant instance, preserving the folder structure:

config/www/hass-evcc-card/
├── evcc-card.js
└── locales/
    ├── index.json
    └── *.json

Register the resource - see Manual resource registration below.
Reload your browser

Manual resource registration

Depending on how your Lovelace is set up, register the resource in one of two ways:

UI mode (default): Go to Settings → Dashboards → ⋮ → Resources and add:

url: /hacsfiles/hass-evcc-card/evcc-card.js  # if installed via HACS
# or
url: /local/hass-evcc-card/evcc-card.js       # if installed manually
type: module

YAML mode (lovelace_mode: yaml in configuration.yaml): Add the resource to your Lovelace YAML configuration file (typically ui-lovelace.yaml or referenced via lovelace: !include):

resources:
  - url: /hacsfiles/hass-evcc-card/evcc-card.js   # if installed via HACS
    type: module
  # or
  - url: /local/hass-evcc-card/evcc-card.js       # if installed manually
    type: module

Then restart Home Assistant or reload the Lovelace resources.

Configuration

Add the card to any Lovelace dashboard and use the visual editor to configure it - all options are available interactively, and the editor shows only the options relevant to the selected mode.

Configuration options

Option	Type	Default	Description
`mode`	`string`	`loadpoint`	Card mode: `loadpoint`, `compact`, `battery`, `site`, `flow`, `grid`, `stats`, `plan`, `repeatplan`, `priority`, `debug`
`title`	`string`	(auto)	Replaces the default card header
`loadpoints`	`list`	(all)	Filter charge points by name
`language`	`string`	(auto)	Override UI language
`size`	`string`	(auto)	Fixed card scale: `small`, `medium` or `large`. When unset, the card auto-scales to its container width
`no_plan`	`list`	(none)	Hide charge plan block for specific charge points
`no_pv`	`list`	(none)	Hide the PV and Min+PV charge modes for specific charge points (useful when no PV system is configured in evcc)
`site_details`	`string`	`expanded`	`collapsed` to hide the IN/OUT detail table by default in `site` and `flow` mode
`charge_current_settings`	`string`	`collapsed`	`expanded` to show charge settings expanded by default
`stats_period`	`string`	`total`	Default statistics period: `total`, `30d`, `365d`, `thisYear`, `none`
`prefix`	`string`	(auto)	YAML only — Entity prefix, auto-detected from ha-evcc. Only needed for multiple EVCC instances with custom prefixes.

YAML Configurator: For users who prefer YAML configuration, the interactive YAML Configurator is still available to generate card configurations for special cases.

Modes

`loadpoint` (default)

The main charge point view. For each discovered charge point it shows:

Charge mode buttons (Off / PV / Min+PV / Now)
Vehicle SoC progress bar with percentage and estimated range
Current charging session: energy, cost, duration, phases
Sliders: Target SoC, Min SoC
Charge plan block

The loadpoint header also shows live action indicators when EVCC has scheduled a pending phase switch or PV-charging change - e.g. "Switching to 3-phase in 0:42" or "PV charging on in 1:15". The chip disappears automatically once the action is executed. Requires ha-evcc with the phase_action / pv_action sensors exposed.

The CHARGE SETTINGS section is collapsed by default and can be toggled using the gear icon. It contains:

Phase switch: Auto / 1-phase / 3-phase
Max current / Min current sliders
Battery boost - lets the vehicle draw from the home battery; the slider sets the battery SoC threshold above which boosting is allowed. Only shown when ha-evcc exposes the battery boost entities (battery_boost_limit, battery_boost)
Priority - PV-surplus priority of this charge point relative to the others
Smart charging limit - threshold below which charging starts automatically; shows "Off" when set to 0; EVCC supports either CO2-based (g/kWh) or price-based (EUR/kWh) - not both simultaneously; the active mode is reflected in the entity's unit
Feed-in priority limit - threshold above which EVCC prioritizes feeding into the grid over charging from PV surplus, shown directly under the smart charging limit. Like the smart charging limit, it follows EVCC's global cost mode, so the slider is in currency/kWh (price mode) or g/kWh (CO2 mode). It has a slider, an "active" hint (from the smart_feed_in_priority_active sensor) and a clear button. The smart_feed_in_priority_limit / smart_feed_in_priority_active entities ship disabled by default in ha-evcc, so the row stays hidden until you enable them

Price mode - slider range issue: When switching the smart charging mode in EVCC from CO2-based to price-based, ha-evcc may not recreate the limit entity. The slider then still shows the CO2 range (0-500 g/kWh) instead of the price range. To fix this, go to Settings -> Devices & Services -> ha-evcc -> Reconfigure, and enable the option "Remove and recreate all Devices".

`site`

Full site energy overview:

PV production bar split into: home consumption / charging / battery / feed-in
Individual PV string values (e.g. BKW, Dach) shown as indented sub-rows
Live power table with IN/OUT sections: Grid import/export, PV generation, home consumption, charging, battery
Battery SoC shown inline in the charging/discharging row
Active charge points shown as indented sub-rows under the charging row

The IN/OUT detail table can be toggled by clicking the power bar. It opens expanded by default; set site_details to collapsed in the editor to start collapsed instead.

`flow`

Sankey-style energy flow diagram showing how energy is distributed from sources to consumers in real time:

Sources (left): PV strings, battery (discharging), grid import — each as a colored node
Consumers (right): home consumption, individual charge points, battery (charging), grid export
Flowing bands connect sources to consumers, with width proportional to power — PV is distributed first, then battery, then grid
Each node shows an MDI icon and current power value; battery and vehicle nodes include SoC as a sub-label
All nodes are clickable to open the Home Assistant entity detail dialog
Collapsible IN/OUT detail table below — click the diagram to toggle (same as site mode)

`grid`

Compact site energy overview with a focus on the current grid status:

Large net grid value with color coding: red for import, green for export
Solar self-sufficiency badge (e.g. 86 % Solar) shown when PV is active
Source chips: active energy sources (PV generation, grid import, battery discharge)
Consumer chips: active consumers (home consumption, charge points with vehicle SoC/temperature, battery charging, grid export)

Deprecation notice: mode: site2 still works but is deprecated and will be removed in a future release. Please migrate to mode: grid.

`stats`

Charging statistics with period selector and a matching bar chart:

Period tabs: 30 days / 365 days / This year / Total - switch with a single tap; the selection is remembered for the session
Three KPIs per period: charged energy (kWh), solar share (%), average price (ct/kWh)
The bar chart adapts to the selected period:

Tab	Chart	Bars
30 days	Daily values	30 bars (day.month labels)
365 days	Rolling monthly	13 bars (3-letter month labels)
This year	Monthly, current calendar year	Jan - current month
Total	One bar per year	All available years

Chart data is fetched lazily per tab on first access and cached for 5 minutes
The same three KPIs also appear as a compact footer row at the bottom of site and grid cards - the period shown there is controlled via stats_period (default: total). Set stats_period to none to hide the footer entirely.

Solar breakdown in the bar chart: When sensor.evcc_stat_total_solar_k_wh_template is available, each bar is split into a green (solar) and blue (grid) portion. This sensor was recently added to ha-evcc - thanks to @marq24 for adding it! The sensor needs at least 3 days of HA Recorder history before the split appears. No configuration is needed - once enough history has been collected, the solar breakdown appears automatically.

Periods not showing data? The Total period is enabled by default in ha-evcc. The sensor entities for 30 days, 365 days and This year are disabled by default in Home Assistant and must be enabled manually. If a period tab shows a warning instead of statistics, follow the steps below.

Enabling the stat entities in Home Assistant

The stat sensors exist in your ha-evcc integration but are disabled by default. To enable them:

In Home Assistant, open Settings -> Devices & Services
Click on the ha-evcc integration
Open your evcc device (e.g. "evcc Solar Charging [evcc]")
Scroll down to the section that says "X disabled entities" and click on it
Enable the statistics entities for the periods you want: 30 days (stat30_*), 365 days (stat365_*) and/or This year (stat_this_year_*)
Each period has three entities: _charged_kwh, _solar_percentage and _avg_price - enable all three for full statistics. Since ha-evcc 2026.2 there is also _solar_k_wh_template which is needed for the solar/grid split in the bar chart
Wait a moment or reload the ha-evcc integration - the stat periods should then appear in the card

Note: After enabling, it may take a few minutes until the first values appear, as Home Assistant needs to record the initial data points for these entities.

Single-year fallback: If the Total tab detects that only one calendar year of data is available in the HA Recorder, it automatically falls back to showing the monthly breakdown of the current year - identical to the This year chart.

`battery`

Home battery management block:

Current battery SoC with visual indicator
Buffer SoC slider
Priority SoC slider
Discharge lock toggle

`priority`

PV surplus priority management: reorder all loadpoints by drag-and-drop to set which one is preferred when distributing PV excess. Higher position = higher priority.

One row per discovered loadpoint, sorted by current priority (highest at top)
Drag the ⋮⋮ handle to reorder; the rendered target value updates live
Rows with a target that differs from the current entity state are highlighted in amber and show the old value as (N) next to the target
Apply writes the new priorities via number.set_value for every loadpoint whose value would change. Values are assigned contiguously: top = N-1, bottom = 0
Reset discards unapplied changes and re-syncs the visible order to the current state
Respects the loadpoints config filter; loadpoints without a priority entity are shown disabled

`compact`

Same content as loadpoint, but organized into four tabs - ideal for dashboards where vertical space is limited or multiple charge points are shown side by side:

Tab	Contents
Control	Charge mode buttons, vehicle SoC bar, current charging power
Settings	Target SoC, Min SoC sliders, phase switch, current limits, battery boost, priority, smart charging limit, feed-in priority limit
Plan	Charge plan: vehicle selector, target time, target SoC, activate/delete
Session	Energy, cost, duration and phases of the current session

The selected tab is remembered per charge point across re-renders.

`plan`

Minimalist charge plan view:

Vehicle selector
Target time picker
Target SoC slider
Continuous charging toggle - keeps the charge running without interruption once started
Preconditioning select - pre-heats/cools the battery before reaching the target SoC (off / minutes / hours / all)
Activate / delete plan

Note: The Continuous charging and Preconditioning controls only appear when ha-evcc exposes the corresponding entities (plan_strategy_continuous, plan_strategy_precondition). The same controls also show up in the plan block of the loadpoint and compact modes.

`repeatplan`

Repeating charge plans per vehicle - evcc's weekly departure schedules:

One block per vehicle, listing each repeating plan
Active weekdays shown as badges, plus the departure time and target SoC
On/off toggle to activate or deactivate a plan directly from the dashboard

Note: Repeating plans can only be created and edited in evcc itself - the card only switches them on or off (an info icon in the header points this out). Requires the repeating plan entities from ha-evcc 2026.6.1+ (repeating_plan_*); on older integration versions the entities do not exist yet and the mode shows an empty state.

`debug`

Diagnostics view for bug reports. Shows everything the card has detected:

Card, Home Assistant and browser versions
ha-evcc integration status (entity count, detected prefix vs. configured prefix)
All discovered charge points with their feature coverage and the list of missing entity suffixes
Site features (found vs. missing)
Orphan entity groups (loadpoint-like but missing charge_power — usually meters or devices with non-standard names)
The current card configuration
Loaded translation files

The Copy report button copies a Markdown-formatted summary to the clipboard, ready to paste into a bug report. An optional Mask names toggle anonymises loadpoint, vehicle and title strings before copying. No live state values or sensor data are included.

Tip: If your card shows "No loadpoints found", click the Open debug mode link in the empty state — orphan groups in the meters bucket are usually the hint to why discovery missed your charge points.

Entity detection

The card automatically detects all ha-evcc entities via the Home Assistant entity registry (platform: evcc_intg). The entity prefix is derived automatically - no configuration needed.

Entities follow the ha-evcc naming convention:

sensor.evcc_<loadpoint_name>_<entity_type>
select.evcc_<loadpoint_name>_mode
number.evcc_<loadpoint_name>_limit_soc
...

Edge case: If you run multiple EVCC instances with a custom prefix (e.g. evcc2_), you can override the auto-detection via YAML:
type: custom:evcc-card
prefix: evcc2_

Translations

The card ships with multiple languages and automatically uses the language configured in Home Assistant. You can override it per card in the visual editor or via the language config option.

Translations are stored as simple JSON files in the dist/locales/ folder. Adding a new language takes only two steps:

Create a new file dist/locales/<lang>.json by copying an existing one (e.g. en.json) and translating the values
Add the language code to dist/locales/index.json

Want to contribute a translation? Pull requests for new languages are very welcome! Have a look at dist/locales/en.json as a starting point and open a PR with your new language file.

FAQ

The solar share visualization in the stats chart requires sensor.evcc_stat_total_solar_k_wh_template, which was introduced in ha-evcc version 2026.3.3. Historical sessions recorded before that version are missing the underlying data, so a correct solar share cannot be calculated retroactively. Only sessions recorded after upgrading to ha-evcc 2026.3.3 or later will show solar share data.

Contributing

Pull requests are welcome! Please open an issue first to discuss what you'd like to change.

Fork the repository
Create a feature branch: git checkout -b feature/my-feature
Commit your changes: git commit -m 'Add my feature'
Push to the branch: git push origin feature/my-feature
Open a Pull Request

Contributions that are especially appreciated:

New translations - see the Translations section above
Bug reports and fixes
Feature suggestions and implementations

Videos & Blog Posts

The card was featured in YouTube videos - showing installation, configuration and usage in practice. Note: the videos are in German.

A detailed blog post about the card is available on smarterkram.de (German).

License

MIT

EVCC - the EV charging controller this card is built for
ha-evcc - the Home Assistant integration providing all entities