--- title: "Span Panel" description: "Span Panel is a Marketplace integration for Home Assistant. Its installs are not shown, because another integration uses the same domain, span_panel. It works locally and was last updated October 26, 2026." canonical: "https://vulpo.app/integrations/marketplace/spanpanel-span" url: "https://vulpo.app/integrations/marketplace/spanpanel-span.md" last-updated: "2026-10-27" version: "1.4" --- # Span Panel > Span Panel is a Marketplace integration for Home Assistant. Its installs are not shown, because another integration uses the same domain, span\_panel. It works locally and was last updated October 26, 2026. From the [repository description](https://github.com/SpanPanel/span): > Default SPAN Integration for HomeAssistant/HACS [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=SpanPanel&repository=span&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=SpanPanel&repository=span&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **Found by itself**: Home Assistant spots it on the network and offers to add it. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Connect to the Span Panel - **Auto-Compensate Energy Dips**: Automatically compensate when the panel reports lower energy readings, preventing spikes in the energy dashboard. - **Energy Display Precision**: Number of decimal places for energy values (0-3) - **Host**: IP address or hostname of SPAN Panel - **HTTP Port**: HTTP port for the panel API (default: 80) - **Power Display Precision**: Number of decimal places for power values (0-3) ### Panel Passphrase - **Passphrase**: The passphrase used to authenticate with the SPAN Panel v2 API ### Circuit entity naming - **Naming pattern**: Friendly names use circuit labels from the panel. Tab-based names use breaker tab numbers for stable entity IDs. ### Panel HTTPS port - **HTTPS port**: Leave at 443 unless a proxy or a port mapping moved it. ### Reconfigure SPAN Panel - **Host**: IP address or hostname of the SPAN Panel - **HTTPS port**: Shown for a panel with a pinned certificate authority. Leave at 443 unless a proxy or a port mapping moved the panel's TLS. ### After setup - **Allow control without a logged-in user**: Automations, scripts and other integrations call services with no user attached. While this is off, those commands are refused. Turn it on if your automations operate circuits. - **Control lock auto-relock (minutes)**: \-1 turns the control lock off and removes its switch. 0 keeps the lock armed until someone disarms it. Any other value re-arms it that many minutes after it is disarmed. Only administrators can disarm it. - **Who may operate the panel**: Home Assistant grants every non-admin user control of every entity by default. Restricting to administrators is the only way to change that. Disabling stops creating the control entities; their registry entries, names and areas are kept. - **Circuit Net Energy**: Net energy per circuit, accounting for reactive power. - **Auto-Compensate Energy Dips**: Compensate when panel reports lower energy readings. Disabling clears offsets. - **Panel Net Energy**: Net energy for main meter and feed-through, accounting for bidirectional flows. - **Energy Sensor Grace Period (minutes)**: Minutes sensors hold last value when panel is offline (0–60). Default: 15. - **Admin Users Only**: Restrict the dashboard sidebar entry to admin users. - **Relay debounce (seconds)**: Refuse a second command to the same circuit's relay within this many seconds. Refused, never queued: a relay command firing seconds late against a changed panel is worse than an error the automation author can see. 0 disables it. - **Show Dashboard in Sidebar**: Display the SPAN Panel dashboard as a sidebar entry. - **Snapshot Update Interval (seconds)**: Seconds between snapshot rebuilds (0–15). Lower = faster, more CPU. 0 = no debounce. Texts from the code of [SpanPanel/span](https://github.com/SpanPanel/span). ## Entities - **Binary sensors**: BESS Connected, Door State, Ethernet Link, Charging, EV Connected, Grid Islandable, Panel Status, Wi-Fi Link, PCS Active, PV Panel Link, EVSE Panel Link - **Buttons**: GFE Override: Grid Connected - **Numbers**: EVSE Charge Current Limit - **Selects**: Circuit Priority - **Sensors**: Battery Level, Battery Power, Firmware Version, Model, Communication State, Nameplate Capacity, Part Number, Serial Number, State of Energy, Vendor, Current Run Config, Downstream L1 Current, and 35 more - **Switches**: Control lock ## Actions - **Export circuit manifest** - **Set circuit threshold**: Set current monitoring thresholds for a specific circuit. Fields: Circuit, Continuous threshold (%), Spike threshold (%), Window duration (minutes), Cooldown duration (minutes), Monitoring enabled, Config entry - **Clear circuit threshold**: Remove per-circuit threshold overrides, reverting to global defaults. Fields: Circuit, Config entry - **Set mains threshold**: Set current monitoring thresholds for a specific mains leg. Fields: Mains leg, Continuous threshold (%), Spike threshold (%), Window duration (minutes), Cooldown duration (minutes), Monitoring enabled, Config entry - **Clear mains threshold**: Remove per-mains-leg threshold overrides, reverting to global defaults. Fields: Mains leg, Config entry - **Get monitoring status**: Returns current monitoring state for all tracked circuits and mains legs. Fields: Config entry - **Set Global Monitoring**: Update global monitoring thresholds and notification settings. Fields: Enabled, Continuous Threshold, Spike Threshold, Window Duration, Cooldown Duration, Notification Targets, Notification Title Template, Notification Message Template, Notification Priority, Config entry - **Test Notification**: Send a test notification to all configured targets using sample values. Fields: Config entry - **Set graph time horizon**: Set the global default time horizon for circuit graphs. Fields: Horizon, Config entry - **Set circuit graph horizon**: Set a per-circuit time horizon override for graphs. Fields: Circuit ID, Horizon, Config entry - **Clear circuit graph horizon**: Remove a per-circuit graph horizon override, reverting to the global default. Fields: Circuit ID, Config entry - **Set sub-device graph horizon**: Set a per-sub-device time horizon override for graphs. Fields: Sub-device ID, Horizon, Config entry - **Clear sub-device graph horizon**: Remove a per-sub-device graph horizon override, reverting to the global default. Fields: Sub-device ID, Config entry - **Get graph settings**: Returns the current global and per-circuit graph horizon settings. Fields: Config entry - **Get favorites**: Returns the saved cross-panel favorites map keyed by SPAN panel device id. - **Add favorite**: Mark a SPAN circuit, battery (BESS), or EV charger (EVSE) as a favorite so it appears in the dashboard's Favorites view. Fields: Entity - **Remove favorite**: Remove a circuit or sub-device from the cross-panel Favorites view. Fields: Entity - **Rotate panel credentials**: Ask the SPAN panel to replace its passphrase, which is currently also its eBus MQTT broker password, store the new broker password, and reload the integration. Both the panel passphrase and the broker password change. Access tokens already issued, including the integration's, are not revoked. The new passphrase is returned in the response and is not stored by the integration, so save it before closing the response. Any other local client using the previous password, such as a second Home Assistant instance, a script, or third-party tooling, must be re-provisioned with the new one. The broker may not accept the new password as soon as the panel returns it, so the integration retries for about a minute before reporting in the response that it did not reconnect. If it did not, run the rotation again, and the integration uses the newly returned password; as a last resort, restart the panel. Only a Home Assistant administrator can run this, and it cannot be called from an automation or script. Fields: Config entry ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices it can show in Settings, Repairs: SPAN Panel data field unavailable, SPAN Panel unit mismatch, SPAN Panel certificate authority changed, SPAN Panel stored certificate authority is unreadable, SPAN Panel HTTPS port is serving an untrusted certificate, SPAN Panel is not at the configured address, SPAN Panel hardware not validated with this release ## From the README > Home Assistant Integration for SPAN Panel, a smart electrical panel that provides circuit-level monitoring and control of your home's electrical system. > > The software is provided as-is with no warranty or guarantee of performance or suitability to your particular setting. From the README of [SpanPanel/span](https://github.com/SpanPanel/span#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Number: Installs not shown: shared domain span\_panel; 50 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v2.1.2, last updated October 26, 2026 - Domain: `span_panel` - Source: - Issues: In Vulpo: Quick Toggle card, Button card, Select card, Chart card, Apple Watch, Control Center Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-27. Source: https://vulpo.app/integrations/marketplace/spanpanel-span --- - HTML version of this page: https://vulpo.app/integrations/marketplace/spanpanel-span - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml