diff --git a/src/content/docs/ci-insights/jobs.mdx b/src/content/docs/ci-insights/jobs.mdx
index 25bc3e4bc3..418c182f8c 100644
--- a/src/content/docs/ci-insights/jobs.mdx
+++ b/src/content/docs/ci-insights/jobs.mdx
@@ -50,3 +50,10 @@ and related test results.
   duration to see whether the failure correlates with a performance
   change.
 :::
+
+## Data Retention
+
+CI Insights keeps 30 days of job history. The free tier keeps only the last 24
+hours, so a date range reaching further back returns nothing older than that
+rather than an error. Both views show a banner when your plan is on the shorter
+window.