diff --git a/docs/user/appearance.md b/docs/user/appearance.md
index 0126c2495b25327d3c3befd4066f9cd570b44efd..0300b8fd99465c2cc78c1a52358c135276809104 100644
--- a/docs/user/appearance.md
+++ b/docs/user/appearance.md
@@ -7,6 +7,13 @@ within each theme. Appearance preferences are saved separately on each device or
 Mobile has its own themes and text, code, and terminal preferences. It does not follow environment
 themes or defaults.
 
+## Motion
+
+The main sidebar, right panel, and terminal drawer open and close immediately by default. Move the
+**Panel animations** slider above 0 ms to add motion, up to 400 ms, unless reduced motion is enabled
+in your operating system. Moving between threads always snaps to the selected thread's panel state
+without replaying its transitions.
+
 ## Custom themes
 
 On web and desktop, choose **Create theme** to adjust a palette, or import a T3 Code or VS Code