diff --git a/shared-bindings/supervisor/Runtime.c b/shared-bindings/supervisor/Runtime.c
index ecdd914a8f..792f18637a 100644
--- a/shared-bindings/supervisor/Runtime.c
+++ b/shared-bindings/supervisor/Runtime.c
@@ -187,8 +187,10 @@ MP_PROPERTY_GETSET(supervisor_runtime_ble_workflow_obj,
     (mp_obj_t)&supervisor_runtime_set_ble_workflow_obj);
 
 //|     next_stack_limit: int
-//|     """The size of the stack for the next vm run. If its too large, the default will be used."""
+//|     """The size of the stack for the next vm run. If its too large, the default will be used.
 //|
+//|     **Limitations**: Stack size is fixed at startup on the ``espressif`` port; setting this will have no effect.
+//|     """
 STATIC mp_obj_t supervisor_runtime_get_next_stack_limit(mp_obj_t self) {
     return mp_obj_new_int(get_next_stack_size());
 }