diff --git a/packages/docs/src/en/magics/refs.md b/packages/docs/src/en/magics/refs.md
index 6c42f5e2d..acfc2446e 100644
--- a/packages/docs/src/en/magics/refs.md
+++ b/packages/docs/src/en/magics/refs.md
@@ -25,3 +25,18 @@ title: refs
 <!-- END_VERBATIM -->
 
 Now, when the `<button>` is pressed, the `<span>` will be removed.
+
+<a name="limitations"></a>
+### Limitations
+
+In V2 it was possible to bind `$refs` to elements dynamically, like seen below:
+
+```alpine
+<template x-for="item in items" :key="item.id" >
+    <div :x-ref="item.name">
+    some content ...
+    </div>
+</template>
+```
+
+However, in V3, `$refs` can only be accessed for elements that are created statically. So for the example above: if you were expecting the value of `item.name` inside of `$refs` to be something like *Batteries*, you should be aware that `$refs` will actually contain the literal string `'item.name'` and not *Batteries*.