From c574a5c1459b1a272a9333d296e87c4c2b88b28a Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Thu, 4 Jun 2026 18:04:06 -0500
Subject: [PATCH] describe alerts vs detections in review usage

---
 docs/docs/usage/review.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/docs/usage/review.md b/docs/docs/usage/review.md
index 4245c995c9..3a789aa017 100644
--- a/docs/docs/usage/review.md
+++ b/docs/docs/usage/review.md
@@ -17,7 +17,9 @@ Review items are only created for a camera when **recording is enabled** for tha
 
 ## Alerts, Detections, and Motion
 
-The toggle at the top of the page switches between three severities. One is always selected.
+Not every segment of video captured by Frigate is of the same level of interest. The people who enter your property may be a higher priority than those just walking by on the sidewalk. For this reason, Frigate sorts **review items** by importance into **alerts** and **detections**, with a separate **Motion** category for significant motion that never became a tracked object.
+
+The toggle at the top of the page switches between these three severities. One is always selected.
 
 | Tab            | Indicator color | What it shows                                                                                                    |
 | -------------- | --------------- | ---------------------------------------------------------------------------------------------------------------- |