geosolutions-it · ElenaGallo · Jul 8, 2026 · Jul 8, 2026 · Jul 17, 2026 · Jul 17, 2026
diff --git a/docs/user-guide/background.md b/docs/user-guide/background.md
@@ -43,6 +43,8 @@ In particular, from this window, the user can perform the following operations:
 
 * Choose the **Style**, between the ones available for that layer
 
+* Enable/disable the *Crop to projection extent*.  If enabled, the background is cropped to the current map projection extent.
+
 * Enable/disable the use of the layer cached tiles. If checked, the *Tiled=true* URL parameter will be added to the WMS request to [use tiles cached with GeoWebCache](https://docs.geoserver.org/latest/en/user/geowebcache/using.html#direct-integration-with-geoserver-wms).
 When the *Use cache options* is enabled, more controls are enabled so that it is possible for the user to check if the current map settings match any GWC ***standard*** Gridset defined on the server side for the given WMS layer (**Check available tile grids information** <img src="../img/button/update_button.jpg" class="ms-docbutton"/>). At the same time, it is also possible to change the setting strategy (based on the WMTS service response) to strictly adapt layer settings on the client side to the ones matching any remote ***custom*** Gridset defined for the current map settings (**Use remote custom tile grids** <img src="../img/button/tile_grid.jpg" class="ms-docbutton"/> button). (More details on [Layer Settings](layer-settings.md#display) section.)
 

diff --git a/docs/user-guide/catalog.md b/docs/user-guide/catalog.md
@@ -232,6 +232,8 @@ Enabling that option, all layers added to the map from this catalog source will
 
 * *Single Tile* (only for the WMS service): if checked, the layers loaded from the involved catalog source are rendered as a single tile. For layers already loaded on the map, it is possible to disable this option through the [Layer Settings](layer-settings.md#display) tool as usual.
 
+* *Crop to projection extent*: If enabled, the layers loaded from the involved catalog source are cropped to the current map projection extent. For layers already loaded on the map, it is also possible to enable this option through the [Layer Settings](https://mapstore.readthedocs.io/en/latest/user-guide/layer-settings/#display) tool.
+
 * *Allow not secure layers*: if enabled allows the unsecure catalog URLs to be used (http only). Adding layers from WMS sources with this option active will also force the layer to use the proxy for all the requests, skipping the mixed content limitation of the browser.
 
 * *Server Type*: to specify the server type of the used WMS service URL. Possible options are two: `Geoserver` or `No Vendor` which can be for example MapProxy, MapServer or other.

diff --git a/docs/user-guide/img/background/add-new-bck.jpg b/docs/user-guide/img/background/add-new-bck.jpg
diff --git a/docs/user-guide/img/catalog/advanced_settings_wms.jpg b/docs/user-guide/img/catalog/advanced_settings_wms.jpg
diff --git a/docs/user-guide/img/layer-settings/display.jpg b/docs/user-guide/img/layer-settings/display.jpg
diff --git a/docs/user-guide/layer-settings.md b/docs/user-guide/layer-settings.md
@@ -84,6 +84,8 @@ In particular, the user is allowed to:
 
 * Enable/disable the *Force proxy* layer option. If enabled, forces the application to check the source and applies proxy if needed.
 
+* Enable/disable the *Crop to projection extent*.  If enabled, the layer is cropped to the current map projection extent.
+
 * Enable/disable the use of the layer cached tiles. If checked, the *Tiled=true* URL parameter will be added to the WMS request to [use tiles cached with GeoWebCache](https://docs.geoserver.org/latest/en/user/geowebcache/using.html#direct-integration-with-geoserver-wms).
 When the *Use cache options* is enabled, more controls are enabled so that it is possible for the user to check if the current map settings match any GWC ***standard*** Gridset defined on the server side for the given WMS layer (**Check available tile grids information** <img src="../img/button/update_button.jpg" class="ms-docbutton"/>). At the same time, it is also possible to change the setting strategy (based on the WMTS service response) to strictly adapt layer settings on the client side to the ones matching any remote ***custom*** Gridset defined for the current map settings (**Use remote custom tile grids** <img src="../img/button/tile_grid.jpg" class="ms-docbutton"/> button).