From 43b40a48c464836864cd12dc6dd76b88bea40ed9 Mon Sep 17 00:00:00 2001
From: "J. Nick Koston" <nick@koston.org>
Date: Sun, 26 Mar 2023 07:52:34 -1000
Subject: [PATCH] Add warning about a window size larger than one with many
 states (#26706)

---
 source/_integrations/filter.markdown | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/source/_integrations/filter.markdown b/source/_integrations/filter.markdown
index e8e4116d644..5c084c1e21e 100644
--- a/source/_integrations/filter.markdown
+++ b/source/_integrations/filter.markdown
@@ -115,6 +115,12 @@ filters:
       default: positive infinity
 {% endconfiguration %}
 
+<div class="note warning">
+
+When configuring a `window_size` that is not a time and with a value larger than the default of `1`, the database must examine nearly every stored state for that entity during Home Assistant startup. If you have modified the [Recorder `purge_keep_days`](/integrations/recorder/#purge_keep_days) value or have many states stored in the database for the filtered entity, this can cause your Home Assistant instance can to respond poorly during startup.
+
+</div>
+
 ## Filters
 
 ### Low-pass