diff --git a/docs/reference/plots/voxel.md b/docs/reference/plots/voxel.md
index 4c33e72029d..90985ff2976 100644
--- a/docs/reference/plots/voxel.md
+++ b/docs/reference/plots/voxel.md
@@ -208,4 +208,13 @@ chunk.val[30:34, :, :] .= NaN # or p.args[end].val
 Makie.local_update(p, 30:34, :, :)
 f
 ```
-\end{examplefigure}
\ No newline at end of file
+\end{examplefigure}
+
+
+
+#### Picking Voxels
+
+The `pick` function is able to pick individual voxels in a voxel plot.
+The returned index is a flat index into the array passed to `voxels`, i.e. `plt.args[end][][idx]` will return the relevant data.
+One important thing to note here is that the returned index is a `UInt32` internally and thus has limited range.
+Very large voxel plots (~4.3 billion voxels or 2048 x 2048 x 1024) can reach this limit and trigger an integer overflow.