diff --git a/docs/feature_encoders.md b/docs/feature_encoders.md
index 60b613d6a5..cccdcbe4b3 100644
--- a/docs/feature_encoders.md
+++ b/docs/feature_encoders.md
@@ -67,6 +67,8 @@ Additionally, if one side does not have an encoder, you can specify `{}` for the
 #define ENCODER_RESOLUTIONS_RIGHT { 4 }
 ```
 
+!> Keep in mind that whenver you change the encoder resolution, you will need to reflash the half that has the encoder affected by the change.
+
 ## Encoder map :id=encoder-map
 
 Encoder mapping may be added to your `keymap.c`, which replicates the normal keyswitch layer handling functionality, but with encoders. Add this to your keymap's `rules.mk`: