diff --git a/src/location/declarativemaps/qdeclarativegeomap.cpp b/src/location/declarativemaps/qdeclarativegeomap.cpp
index e4bf10a6918186055690c74a7bf31e0a91b8eb57..1638d1c8e4b30eba2430d0ae82bc7fe549c35716 100644
--- a/src/location/declarativemaps/qdeclarativegeomap.cpp
+++ b/src/location/declarativemaps/qdeclarativegeomap.cpp
@@ -936,7 +936,9 @@ qreal QDeclarativeGeoMap::maximumZoomLevel() const
     This property holds the zoom level for the map.
 
     Larger values for the zoom level provide more detail. Zoom levels
-    are always non-negative. The default value is 8.0.
+    are always non-negative. The default value is 8.0. Depending on the plugin in use,
+    values outside the [minimumZoomLevel, maximumZoomLevel] range, which represent the range for which
+    tiles are available, may be accepted, or clamped.
 */
 void QDeclarativeGeoMap::setZoomLevel(qreal zoomLevel)
 {
diff --git a/src/location/maps/qgeocameracapabilities.cpp b/src/location/maps/qgeocameracapabilities.cpp
index d5a2f11eb86b0279f723dbc3197fd2f392021900..bb6ec4d3994d1257648d96f8c6ef294fa1850040 100644
--- a/src/location/maps/qgeocameracapabilities.cpp
+++ b/src/location/maps/qgeocameracapabilities.cpp
@@ -438,6 +438,14 @@ double QGeoCameraCapabilities::maximumFieldOfView() const
 /*!
     Sets whether overzooming is supported by the associated plugin.
 
+    Overzooming means that zoom levels outside the [minimumZL, maximumZL] range can be set,
+    and if tiles aren't available for those zoom levels, either tiles from other zoom levels
+    will be used, or nothing will be shown.
+
+    Set this value to false if the plugin is not capable of that. For example if using
+    a mapping engine that always clamp the zoomLevel value, which may cause misalignment in case
+    of stacked map elements.
+
     \since 5.9
 */
 void QGeoCameraCapabilities::setOverzoomEnabled(bool overzoomEnabled)