diff --git a/src/libcamera/control_ids.yaml b/src/libcamera/control_ids.yaml
index 76d41f5f2a5a..985f792a53c1 100644
--- a/src/libcamera/control_ids.yaml
+++ b/src/libcamera/control_ids.yaml
@@ -408,7 +408,15 @@ controls:
             LensPosition control.
 
             In this mode the AfState will always report AfStateIdle.
-        - name: AfModeAuto
+
+            If the camera is started is AfModeManual, it will move the focus
+            lens to the position specified by the LensPosition control.
+
+            This mode is the recommended default value for the AfMode control.
+            External cameras (as reported by the Location property set to
+            CameraLocationExternal) may use a different default value.
+
+         name: AfModeAuto
           value: 1
           description: |
             The AF algorithm is in auto mode. This means that the algorithm