diff --git a/include/SDL3/SDL_hints.h b/include/SDL3/SDL_hints.h
index 0ba148d024..3d00d79515 100644
--- a/include/SDL3/SDL_hints.h
+++ b/include/SDL3/SDL_hints.h
@@ -4758,6 +4758,8 @@ extern "C" {
  * players are using high DPI mice, but should be disabled while showing
  * custom assert dialogs in your application code.
  *
+ * Caution: Windows will not see mouse button releases in relative mode with this active. This means you should not enable relative mode while a mouse button is currently pressed.
+ *
  * - "0": Windows mouse events will be generated while relative motion is
  *   enabled. (default)
  * - "1": Windows mouse events will not be generated while relative motion is