From 388840b1b29d9f02aebc649f705f4a01ca1c4b51 Mon Sep 17 00:00:00 2001
From: Rudevin <101231071+Rudevin17@users.noreply.github.com>
Date: Thu, 20 Aug 2026 21:23:11 +0800
Subject: [PATCH] docs: note that transitions bypass CSS prefers-reduced-motion
 (#18597)

---------

Co-authored-by: Simon H <5968653+dummdidumm@users.noreply.github.com>
---
 documentation/docs/03-template-syntax/14-transition.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/documentation/docs/03-template-syntax/14-transition.md b/documentation/docs/03-template-syntax/14-transition.md
index 9b14b7b25b..5f722259b5 100644
--- a/documentation/docs/03-template-syntax/14-transition.md
+++ b/documentation/docs/03-template-syntax/14-transition.md
@@ -53,6 +53,12 @@ Transitions can have parameters.
 {/if}
 ```
 
+## Accessibility
+
+Transitions are driven by the [Web Animations API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API) rather than by CSS. A global `@media (prefers-reduced-motion: reduce)` rule that zeroes `transition-duration` and `animation-duration` therefore has no effect on them.
+
+Use [`prefersReducedMotion`](svelte-motion#prefersReducedMotion) to adjust (or completely disable) the transition accordingly for devices who request reduced motion.
+
 ## Custom transition functions
 
 ```js