diff --git a/doc/lua_api.md b/doc/lua_api.md
index 390d9ae92e..b9ccf5eb3e 100644
--- a/doc/lua_api.md
+++ b/doc/lua_api.md
@@ -8895,8 +8895,8 @@ Player properties need to be saved manually.
     stepheight = 0,
     -- If positive number, object will climb upwards when it moves
     -- horizontally against a `walkable` node, if the height difference
-    -- is within `stepheight`.
-    -- Values bigger than twice the collisionbox Y won't work.
+    -- is within `stepheight` and if the object current max Y is greater
+    -- or equal than the node max Y.
 
     automatic_face_movement_dir = 0.0,
     -- Automatically set yaw to movement direction, offset in degrees.