diff --git a/doc/administration/pages/index.md b/doc/administration/pages/index.md
index 17d72b96a51df0ba9dc497170ac2346c3658cfed..1373bd56fe3a874f544f25963f2e19b0307fcca4 100644
--- a/doc/administration/pages/index.md
+++ b/doc/administration/pages/index.md
@@ -174,6 +174,10 @@ behavior:
 
 1. [Reconfigure GitLab][reconfigure].
 
+NOTE: **Note:**
+`inplace_chroot` option might not work with the other features, such as [Pages Access Control](#access-control).
+The [GitLab Pages README](https://gitlab.com/gitlab-org/gitlab-pages#caveats) has more information about caveats and workarounds.
+
 ## Advanced configuration
 
 In addition to the wildcard domains, you can also have the option to configure