diff --git a/docs/container.md b/docs/container.md
index 1d0ad99e51..9cbe208ed3 100644
--- a/docs/container.md
+++ b/docs/container.md
@@ -123,7 +123,7 @@ This feature requires the `apptainer` tool to be installed where the workflow ex
 Nextflow caches those images in the `apptainer` directory in the pipeline work directory by default. However it is suggested to provide a centralised cache directory by using either the `NXF_APPTAINER_CACHEDIR` environment variable or the `apptainer.cacheDir` setting in the Nextflow config file.
 
 :::{versionadded} 21.09.0-edge
-When looking for a Apptainer image file, Nextflow first checks the *library* directory, and if the image file is not found, the *cache* directory is used s usual. The library directory can be defined either using the `NXF_APPTAINER_LIBRARYDIR` environment variable or the `apptainer.libraryDir` configuration setting (the latter overrides the former).
+Nextflow first checks the library directory when retrieving Apptainer images. The cache directory is used if the image file is not found. The library directory can also be defined using the `NXF_APPTAINER_LIBRARYDIR` environment variable. The `apptainer.libraryDir` configuration option overrides `NXF_APPTAINER_LIBRARYDIR` environment variable if both are set.
 :::
 
 :::{warning}
@@ -652,7 +652,7 @@ The `library://` pseudo-protocol allows you to import Singularity images from a
 Nextflow caches the images in `${NXF_WORK}/singularity` by default. However, it is recommended to define a centralised cache directory using either the `NXF_SINGULARITY_CACHEDIR` environment variable or the `singularity.cacheDir` setting in the Nextflow config file.
 
 :::{versionadded} 21.09.0-edge
-When looking for a Singularity image file, Nextflow first checks the *library* directory, and if the image file is not found, the *cache* directory is used as usual. The library directory can be defined either using the `NXF_SINGULARITY_LIBRARYDIR` environment variable or the `singularity.libraryDir` configuration setting (the latter overrides the former).
+Nextflow first checks the library directory when retrieving Singularity images. The cache directory is used if the image file is not found. The library directory can also be defined using the `NXF_SINGULARITY_LIBRARYDIR` environment variable. The `singularity.libraryDir` configuration option overrides `NXF_SINGULARITY_LIBRARYDIR` environment variable if both are set.
 :::
 
 :::{warning}
diff --git a/docs/reference/config.md b/docs/reference/config.md
index 464ca480ba..4d92dd31b7 100644
--- a/docs/reference/config.md
+++ b/docs/reference/config.md
@@ -52,6 +52,13 @@ The following settings are available:
 `apptainer.envWhitelist`
 : Comma separated list of environment variable names to be included in the container environment.
 
+`apptainer.libraryDir`
+: Directory where remote Apptainer images are retrieved. When using a computing cluster it must be a shared folder accessible to all compute nodes.
+
+  :::{versionadded} 21.09.0-edge
+  Nextflow first checks the library directory when retrieving Apptainer images. The cache directory is used if the image file is not found. The library directory can also be defined using the `NXF_APPTAINER_LIBRARYDIR` environment variable. The `apptainer.libraryDir` configuration option overrides `NXF_APPTAINER_LIBRARYDIR` environment variable if both are set.
+  :::
+
 `apptainer.noHttps`
 : Pull the Apptainer image with http protocol (default: `false`).
 
@@ -1375,6 +1382,13 @@ The following settings are available:
 `singularity.envWhitelist`
 : Comma separated list of environment variable names to be included in the container environment.
 
+`singularity.libraryDir`
+: Directory where remote Singularity images are retrieved. When using a computing cluster it must be a shared folder accessible to all compute nodes.
+
+  :::{versionadded} 21.09.0-edge
+  Nextflow first checks the library directory when retrieving Singularity images. The cache directory is used if the image file is not found. The library directory can also be defined using the `NXF_SINGULARITY_LIBRARYDIR` environment variable. The `singularity.libraryDir` configuration option overrides `NXF_SINGULARITY_LIBRARYDIR` environment variable if both are set.
+  :::
+
 `singularity.noHttps`
 : Pull the Singularity image with http protocol (default: `false`).