diff --git a/docs/admin/permissions/webhooks.mdx b/docs/admin/permissions/webhooks.mdx
index 21c4b156c..f0e9f3d99 100644
--- a/docs/admin/permissions/webhooks.mdx
+++ b/docs/admin/permissions/webhooks.mdx
@@ -4,7 +4,7 @@ Sourcegraph allows customers to use webhooks to react to events that modify user
 on the code host. Currently the only supported code host for webhooks
 is [Github](/admin/code_hosts/github).
 
-> NOTE: Using webhooks is the *recommended* way to get code host permissions to Sourcegraph
+> NOTE: Using webhooks is the *recommended* way to get code host permissions to Sourcegraph. It's important to also note that when you  have webhooks configured, it override Sourcegraph's default heuristics for fetching repository permissions. This is because webhooks and explicit configurations are intended to enforce specific permissions from external services, while the default heuristics act as a fallback when no explicit permissions are provided.
 
 ## How it works