From dcbf67ee0e2c5f8d76fecf953bdc838b75c18080 Mon Sep 17 00:00:00 2001
From: TomJaeger <Tom@PacketTide.com>
Date: Mon, 2 Mar 2026 14:20:49 -0500
Subject: [PATCH] adding changelog for 7.5.21

---
 docs/installation/changelog.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/installation/changelog.md b/docs/installation/changelog.md
index fd8414ca..03e409f3 100755
--- a/docs/installation/changelog.md
+++ b/docs/installation/changelog.md
@@ -8,6 +8,29 @@
 -->
 # ExpressionEngine v7 Change Log
 
+## Version 7.5.21
+(Release: March 2nd, 2026)
+<div class="max-w-7xl mx-autotext-center">
+<div class="space-y-8 sm:space-y-12">
+    <ul role="list" class="mx-auto grid grid-cols-2 gap-x-4 gap-y-1 sm:grid-cols-4 md:gap-x-6 lg:max-w-5xl lg:gap-x-8 lg:gap-y-1 xl:grid-cols-5">
+<li><div class="space-y-4 text-center"><img class="mx-auto h-20 w-20 rounded-full lg:w-24 lg:h-24" src="https://avatars.githubusercontent.com/u/422821?v=4" /><div class="space-y-2"><div class="text-xs font-medium lg:text-sm"><p class="mb-1">Tom Jaeger</p><p class="text-indigo-600"><a href="https://github.com/ExpressionEngine/ExpressionEngine/commits?author=TomJaeger" target="_BLANK">@TomJaeger</a></p></div></div></div></li>
+<li><div class="space-y-4 text-center"><img class="mx-auto h-20 w-20 rounded-full lg:w-24 lg:h-24" src="https://avatars.githubusercontent.com/u/563996?v=4" /><div class="space-y-2"><div class="text-xs font-medium lg:text-sm"><p class="mb-1">Bryan Nielsen</p><p class="text-indigo-600"><a href="https://github.com/ExpressionEngine/ExpressionEngine/commits?author=bryannielsen" target="_BLANK">@bryannielsen</a></p></div></div></div></li>
+    </ul>
+</div>
+</div>
+
+**Bug Fixes** 💃🐛
+
+- Resolved an issue where file usage parsing could fail when content contained bare legacy filedir tokens (for example `{filedir_7}` without a relative path), preventing errors in nested content contexts [#5171](https://github.com/ExpressionEngine/ExpressionEngine/pull/5171)
+- Hardened the Translate utility save flow to only persist expected translation keys and reject unexpected/non-scalar posted values [#5173](https://github.com/ExpressionEngine/ExpressionEngine/pull/5173)
+- Improved Translate utility resilience when language files are invalid or malformed by surfacing CP issue alerts and safely falling back [#5173](https://github.com/ExpressionEngine/ExpressionEngine/pull/5173)
+
+**Developers** 💻
+
+- Added extensive tests for Translate utility validation, file generation safety, and error handling [#5173](https://github.com/ExpressionEngine/ExpressionEngine/pull/5173)
+- Added tests for `FileUsageTrait` handling of bare filedir tokens [#5171](https://github.com/ExpressionEngine/ExpressionEngine/pull/5171)
+- Updated GitHub Actions test workflows to support Cypress dashboard toggling and full-suite fallback behavior [#5176](https://github.com/ExpressionEngine/ExpressionEngine/pull/5176)
+
 
 ## Version 7.5.20
 (Release: February 26th, 2026)