Add useful information about Group Access tokens (GitLab & Gitlab-Self-Hosted) (#480)

karan925 · web-flow · commit 530bacbb3ad9 · 2025-07-30T17:05:07.000-07:00
diff --git a/docs/platforms/gitlab-com.mdx b/docs/platforms/gitlab-com.mdx
@@ -107,7 +107,13 @@ By default, GitLab restricts this option to users on the Premium or Ultimate tie
 5. Ensure the following scopes are selected: `api`.
 6. Ensure Developer Access is provided.
 
----
+:::tip
+
+Group Access Tokens create bot users with generic GitLab-generated usernames (like `group_63_bot_5753...`). If you prefer a more descriptive username for your CodeRabbit bot, you can customize it using the [GitLab API](https://docs.gitlab.com/api/users/#modify-a-user).
+
+You can find the bot's user ID through the CodeRabbit UI if connected, or by visiting the bot user's profile from your Group Members page in GitLab.
+
+:::
 
 ### Where to Provide CodeRabbit the Access Token
 
diff --git a/docs/platforms/self-hosted-gitlab.md b/docs/platforms/self-hosted-gitlab.md
@@ -71,6 +71,12 @@ After the user is created, you can retrieve the **User ID** from that user's
 profile and generate an [**access token**](#generating-personal-access-token).
 The access token is used to post reviews on merge requests.
 
+:::note
+
+If you prefer, you can create a Group Access Token which will create a dedicated user on your behalf. For more information, see [Group Access Token](/docs/platforms/gitlab-com.mdx#group-access-token)
+
+:::
+
 We recommend using the CodeRabbit [logo](/img/integrations/logo.png) as the profile picture to ensures easy recognition.
 
 #### **Creating OAuth2 application**
