From c42a96305c334b7f843c461ed9d2623992350f87 Mon Sep 17 00:00:00 2001
From: Jack Journeyman <145021130+jackjourneyman@users.noreply.github.com>
Date: Mon, 5 May 2025 10:00:44 +0100
Subject: [PATCH] Update history-graph.markdown (#38858)

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
---
 source/_dashboards/history-graph.markdown | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/source/_dashboards/history-graph.markdown b/source/_dashboards/history-graph.markdown
index b1f6bdf0ef8..3a0e1e8b3b7 100644
--- a/source/_dashboards/history-graph.markdown
+++ b/source/_dashboards/history-graph.markdown
@@ -93,6 +93,12 @@ name:
   type: string
 {% endconfiguration %}
 
+### Long term statistics
+
+Home Assistant saves long-term statistics for a sensor if the entity has a state_class of measurement, total, or total_increasing. For short-term statistics, a snapshot is taken every 5 minutes. For long-term statistics, an hourly aggregate is stored of the short-term statistics. Short-term statistics are automatically purged after a predefined period (default is 10 days). Long-term statistics are never purged.
+
+In the history graph card, if the hours to show variable is set to a figure higher than the purge_keep period, long-term statistics will be used, with short term statistics shown in bold.
+
 ### Examples
 
 ```yaml