diff --git a/src/libcamera/property_ids.yaml b/src/libcamera/property_ids.yaml
index 7261263a..022cf65d 100644
--- a/src/libcamera/property_ids.yaml
+++ b/src/libcamera/property_ids.yaml
@@ -663,4 +663,24 @@ controls:
         \todo Rename this property to ActiveAreas once we will have property
               categories (i.e. Properties::PixelArray::ActiveAreas)
 
+  - ScalerCropMaximum:
+      type: Rectangle
+      description: |
+        The size and location, in native sensor pixels, of the part of the
+        sensor that is rescaled to produce the output images. Note that the
+        units remain native sensor pixels, even if the sensor is being used in
+        a binning skipping or scaling mode.
+
+        The (x,y) location of this rectangle is relative to the
+        PixelArrayActiveArea that is being used. The property also takes into
+        account any further cropping being done by the CSI-2 receiver or
+        elsewhere.
+
+        This property is valid only after the Camera has been successfully
+        configured and its value changes whenever a new configuration is
+        applied.
+
+        \todo Turn this property into a "maximum control value" for the
+        ScalerCrop control once "dynamic" controls have been implemented.
+
 ...