From 2b2bb1fab8ffd0bec80f97aeb34e65cd85bd3ee7 Mon Sep 17 00:00:00 2001 From: Jason Goodman Date: Wed, 7 Feb 2024 17:27:41 -0500 Subject: [PATCH] Fix erroneous documentation about groups user cap Groups user cap does consider whether or not users are billable. For instance, guest users on an ultimate subscription do not consume a seat. Update note to accurately describe problem: Guest users cannot be added on an Ultimate subscription once the user cap has been reached. --- doc/user/group/manage.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/user/group/manage.md b/doc/user/group/manage.md index b91b5d7ce6ac1c..fd2a43b201c0b2 100644 --- a/doc/user/group/manage.md +++ b/doc/user/group/manage.md @@ -308,7 +308,7 @@ in the hierarchy. To ensure that the user cap applies when groups, subgroups, or projects are shared externally, restrict group sharing only within the top-level namespace. This ensure that groups in the same top-leve namespace can be invited, and prevents the addition of new users (seats) when the group is shared. -User cap doesn’t consider whether users are billable or not (e.g., Free Guest Users in Ultimate). In other words, if you set a cap of 500, user caps block new sign-ups after 500 users, regardless of whether those are all consuming paid seats or not. +On GitLab.com, on the Ultimate tier, there is a [known issue](https://gitlab.com/gitlab-org/gitlab/-/issues/441504) where you cannot add new guest users to a group when the amount of billable users exceeds the user cap. For example, suppose you have a user cap of 5, with 3 developers and 2 guests. After you add 2 more developers, you cannot add any more users, even if they are guest users that don't consume a billable seat. ## Group file templates -- GitLab