diff --git a/docs/release-notes/rl-2605.md b/docs/release-notes/rl-2605.md
index 4758869a..848802dd 100644
--- a/docs/release-notes/rl-2605.md
+++ b/docs/release-notes/rl-2605.md
@@ -24,6 +24,10 @@ changes are only active if the `home.stateVersion` option is set to
   configuration directory (usually `~/.config/zsh`) when
   [](#opt-xdg.enable) is true.
 
+- The [](#opt-programs.yazi.shellWrapperName) option now defaults to
+  `y` instead of `yy`. For users with older `home.stateVersion` values,
+  the legacy default `yy` is retained.
+
 - The [](#opt-xdg.userDirs.setSessionVariables) option now defaults to `false`
   instead of `true`.
 
diff --git a/modules/misc/news/2026/02/2026-02-13_14-17-15.nix b/modules/misc/news/2026/02/2026-02-13_14-17-15.nix
new file mode 100644
index 00000000..1596a623
--- /dev/null
+++ b/modules/misc/news/2026/02/2026-02-13_14-17-15.nix
@@ -0,0 +1,9 @@
+{ config, ... }:
+{
+  time = "2026-02-13T20:17:15+00:00";
+  condition = config.programs.yazi.enable;
+  message = "
+      The option `programs.yazi.shellWrapperName` default has changed from `yy` to `y`
+      to align with the recommendation from upstream.
+    ";
+}