Repository navigation
🚀 Advanced History v2.2.1
Version 2.2 introduces the Advanced History dashboard card, native History source filters, shared date navigation, embedded state history, chart-detail controls, improved comparisons and visibility controls, and expanded categorical and climate history support.
Important
This release requires Statistics Graph Chart Card v4.03 or newer. Update it through HACS before installing Advanced History v2.2.1.
📊 Advanced History dashboard card
- Added
custom:advanced-history-sgcc-card. - Export the active Advanced History panel while retaining date navigation and grouped charts.
- Added editable titles and access to SGCC Graph Settings.
- Graph Settings changes are saved back to the dashboard card.
- Added synchronized date navigation between grouped cards.
- Added optional data downloads, including ZIP exports containing separate CSV files for grouped charts.
- Added support for creating a new dashboard view during export.
- Exported cards default to Home Assistant’s Full width layout.
- Added Auto, Fine and Manual detail controls.
- Added comparison, running-total, visibility and state-strip controls.
- Improved sizing, editor layout, legend ordering and configuration persistence.
🎯 Native History source filters
- Added Home Assistant 2026.9 native History source panes for Y1 and Y2.
- Added native Type and Integration filters with counts.
- Area, floor, device and label targets resolve their complete filtered entity lists.
- Individual entities inside broad targets can be temporarily hidden without removing the parent target.
- Added independent Primary and Secondary axis controls.
- Source filters and pane state are retained across panels, bookmarks and chart history.
- Added native mobile bottom sheets for targets, bookmarks and chart history.
- Older Home Assistant versions continue to use the legacy target picker automatically.
📅 Date navigation and chart detail
- Replaced the previous Energy-based period selector with a shared Advanced History date controller.
- Added fixed and rolling live ranges shared by AHP and AHC.
- Added optional automatic date-selector hiding.
- Added Auto, Fine and Manual chart-detail modes.
- Fine mode selects a higher-resolution grouping appropriate for the displayed period.
- Manual mode exposes Points per hour and Group by controls.
- Added an optional detail-mode banner.
- Detail mode, manual grouping and banner visibility are retained by bookmarks and dashboard cards.
- Fixed the selector remaining visible after using Now, previous or next.
- Improved mobile layout, transitions and panel-tab navigation.
🔄 Comparisons and running totals
- Added comparison settings menus with period and comparison-count controls.
- Added the matching comparison menu to Y2.
- Y1 and Y2 can use different comparison counts while sharing Y1’s comparison period.
- Y2 comparisons can be enabled or disabled independently.
- Comparison legends, banners and tooltips display their actual dates and years.
- Added optional running totals for individual entities or complete axes.
- Running totals preserve gaps and correctly align comparison values.
- Comparison and running-total configuration remains stable across refreshes, reconnects and exports.
📈 Charts and state history
- Numeric series are grouped using Home Assistant units and device classes.
- Compatible Y2 series remain overlaid on their Y1 chart using the secondary scale.
- Added optional state-history strips beneath numeric charts with an aligned time axis.
- State strips are retained by bookmarks, Undo/Redo and exported dashboard cards.
- Improved automatic chart height and full-panel sizing.
- Numeric recorder responses are passed directly to SGCC.
- Added boolean attribute support for values such as
is_calling_for_heatandis_heating. - Boolean attributes render as categorical
TrueandFalsehistory. Falseuses the inactive colour whileTrueuses the entity’s series colour.
🌡️ Climate and More Info history
- Added native climate history for current temperature, target temperature and target ranges.
- Climate targets include their state history alongside numeric attributes.
- Climate activity overlays now follow the recorded
hvac_action. - Idle configured modes no longer incorrectly shade charts.
- Heating, cooling, preheating, defrosting, drying and fan activity are highlighted when recorded.
- Applied climate activity overlays consistently to AHP and More Info graphs.
- Fixed stale More Info updates that could make charts disappear during rapid navigation.
- User-created chart annotations remain preserved.
👁️ Chart visibility
- Ordinary legend clicks and Y1/Y2 visibility buttons temporarily hide chart series.
- Temporary chart hiding does not remove source entities or modify bookmarks.
- Command-click on macOS or Ctrl-click on Windows/Linux toggles SGCC’s persistent Hide on load setting.
- Persistent hiding supports main entities and individual comparison lines.
- Existing bookmark visibility settings are migrated to SGCC’s native configuration.
- Expanding or collapsing source panes no longer resets temporary legend visibility.
🔖 Bookmarks and panels
- Added bookmark reordering and renaming.
- Added panel-specific target display names.
- Added comparison and detail information to bookmark state.
- Loaded bookmarks correctly detect supported persistent changes and expose Update.
- Improved restoration of panel, filter, comparison and chart state.
- Added clearer Y1/Y2 button states and axis-specific colours.
🐛 Additional fixes
- Fixed Advanced History controls becoming unresponsive on mobile after closing a source sheet.
- Fixed automatic-height charts shrinking after source or visibility changes.
- Fixed chart data disappearing after entering or leaving editor mode.
- Fixed linked dashboard cards using different automatic grouping intervals.
- Fixed comparison configuration reverting or leaking into exports.
- Fixed hidden climate entities leaving activity annotations visible.
- Fixed duplicate or unstable automatic series colours.
- Fixed target lists jumping while scrolling.
- Fixed target Attributes controls disappearing or failing to open.
- Fixed date and comparison controls overflowing on narrow layouts.
🛠️ v2.2.1 maintenance update
- Fixed the date selector layout when automatic hiding is disabled.
- The chart now resizes dynamically to keep the docked date selector visible.
- Prevented the docked selector from overlapping chart legends.
- Improved behavior when resizing the browser window or using shorter displays.
⬆️ Updating with HACS
- Update Statistics Graph Chart Card to v4.03 or newer.
- Open HACS → Integrations → Advanced History.
- Select Update.
- Restart Home Assistant.
- Refresh your browser or fully close and reopen the Home Assistant app.
If the stable release is not offered automatically, open the three-dot menu, choose Redownload, and select v2.2.1.
📦 Manual update
- Install Statistics Graph Chart Card v4.03 or newer.
- Download
advanced_history.zipfrom this release. - Replace
/config/custom_components/advanced_historywith the contents of the ZIP. - Restart Home Assistant.
- Refresh the browser or reopen the Home Assistant app.
Full changelog: v2.1.0...v2.2.1