diff --git a/README.md b/README.md
index 298d71f..93f25ba 100644
--- a/README.md
+++ b/README.md
@@ -228,6 +228,7 @@ If you changed the keyboard name or did a settings reset:
 ### When to reset
 
 Do a settings reset when:
+- **Layer structure changed** (layers added, removed, or reordered) — ZMK Studio saved state stores the old layer layout and will override the new compiled keymap
 - Layers are not switching correctly after flashing new firmware
 - Keyboard name didn't change after flash
 - Both halves won't pair with each other