diff --git a/config.example.yaml b/config.example.yaml
index 14df23d..09897b9 100644
--- a/config.example.yaml
+++ b/config.example.yaml
@@ -128,6 +128,11 @@ integration:
 # (This is optional, but recommended for the best experience)
 oidc:
   issuer: "https://accounts.google.com"
+
+  # For the best experience please ensure this is *identical* to the client_id
+  # you are using for Headscale. A lot of OIDC providers will use different
+  # subjects per user based on the client_id and for this to work correctly
+  # they need to be identical between Headscale and Headplane.
   client_id: "your-client-id"
 
   # The client secret for the OIDC client