diff --git a/src/pages/docs/release-notes.mdx b/src/pages/docs/release-notes.mdx
index 724068bd..ea77b69f 100644
--- a/src/pages/docs/release-notes.mdx
+++ b/src/pages/docs/release-notes.mdx
@@ -5,6 +5,43 @@ description: "Latest Future AGI release notes covering new features, improvement
 
 {/* release-notes:insert-below — automation inserts new releases here; do not remove */}
 
+## v1.25.0 (2026-08-07)
+
+<div class="mb-12 pb-8 border-b border-[var(--color-border-subtle)] last:border-b-0">
+
+<div class="mt-6 mb-3 text-lg font-semibold">Features</div>
+
+- **annotations:** add View session action for trace/span queue items ([5b7d1a0](https://github.com/future-agi/future-agi/commit/5b7d1a09a06a2778696bc98bf6d80c494de68fd1))
+
+- **frontend:** branded loading screens + click-to-map variable mapping ([#1847](https://github.com/future-agi/future-agi/issues/1847)) ([158acc5](https://github.com/future-agi/future-agi/commit/158acc5665cb6454fab89f32b46da21eacd66136))
+
+- optimized eval-usage backfill script + seed NodeTemplates on migrate (TH-7012, TH-6727) ([7e79aa1](https://github.com/future-agi/future-agi/commit/7e79aa142d460ba3ca1ad009009e7f5d9bd131c0))
+
+- **oss:** self-hosted first-run setup, browser signup and invite links [TH-7217] ([#1919](https://github.com/future-agi/future-agi/issues/1919)) ([772575e](https://github.com/future-agi/future-agi/commit/772575e15b71d9794aea0b77e5877c41ffc92ab2))
+
+<div class="mt-6 mb-3 text-lg font-semibold">Bugs/Improvements</div>
+
+- **evals:** show entitlement errors in-cell for OSS agent eval denials ([f843300](https://github.com/future-agi/future-agi/commit/f843300e4b39d3847db82284ed31d985c0c76262))
+
+- **gateway:** use guardrail label for the configure modal title [TH-3989] ([#1885](https://github.com/future-agi/future-agi/issues/1885)) ([0711d79](https://github.com/future-agi/future-agi/commit/0711d79bb171aa988c69c699e573e4ca66aee992))
+
+- **oss:** add dark-theme assets for agent scenario help modal [TH-7273] ([#1927](https://github.com/future-agi/future-agi/issues/1927)) ([66228d2](https://github.com/future-agi/future-agi/commit/66228d274dccf547dac9867403d8239a4994fe6f))
+
+- **oss:** disable Imagine button in detail drawers on OSS ([#1907](https://github.com/future-agi/future-agi/issues/1907)) ([d37b4fe](https://github.com/future-agi/future-agi/commit/d37b4fe5e20d92f40c409554e7700afbcd818c5a))
+
+- **oss:** make trace selection Actions button a filled toolbar pill [TH-7265] ([#1928](https://github.com/future-agi/future-agi/issues/1928)) ([391db7d](https://github.com/future-agi/future-agi/commit/391db7d564bf750693fd3b5a7ea54b440cf7511e))
+
+- **oss:** require a model on every eval save, test and add [TH-7258] ([#1941](https://github.com/future-agi/future-agi/issues/1941)) ([0789638](https://github.com/future-agi/future-agi/commit/07896386ba7e747b3845cf54255b33762d1d7ca3))
+
+- **oss:** size gateway key dialog inputs and stop browser autofill highlight [TH-7272] ([#1925](https://github.com/future-agi/future-agi/issues/1925)) ([b381a13](https://github.com/future-agi/future-agi/commit/b381a132c17130c39f22853be5dcdd28df555b04))
+
+- **oss:** tint annotation label-type chips for dark theme [TH-7263] ([#1942](https://github.com/future-agi/future-agi/issues/1942)) ([ce59eac](https://github.com/future-agi/future-agi/commit/ce59eac769f71c00c09e8497d0a9717ebf4bf62c))
+
+- **oss:** upgrade-gate cropping, upload button label, numeric label zero [TH-7282, TH-7253, TH-7268] ([#1937](https://github.com/future-agi/future-agi/issues/1937)) ([2b6420a](https://github.com/future-agi/future-agi/commit/2b6420a611850f41e0dadd23b1157008f2e851d4))
+
+</div>
+
+
 ## Week of 2026-06-18
 
 <div class="mb-12 pb-8 border-b border-[var(--color-border-subtle)] last:border-b-0">