From 74e1972ae5f3d285941a11be053e06d1b698ff7a Mon Sep 17 00:00:00 2001 From: Christina Lohr Date: Wed, 23 Jul 2025 17:31:23 +0200 Subject: [PATCH 1/7] Update Admin area > Groups docs --- doc/administration/admin_area.md | 29 +++++++++++++++-------------- 1 file changed, 15 insertions(+), 14 deletions(-) diff --git a/doc/administration/admin_area.md b/doc/administration/admin_area.md index c09b500bced947..576aa2cf1ef930 100644 --- a/doc/administration/admin_area.md +++ b/doc/administration/admin_area.md @@ -263,27 +263,28 @@ It is also possible to limit which roles can To administer all groups in the GitLab instance: 1. On the left sidebar, at the bottom, select **Admin**. -1. Select **Overview** > **Groups**. The page shows the group's: +1. Select **Overview** > **Groups**. The page shows each group's: - - Name. - - Description. - - Size. - - Number of projects in the group. - - Member count. - - Privacy level: whether the group is private, internal, or public. + - Name + - Description + - Visibility level + - Storage size + - Number of subgroups + - Number of projects + - Member count +1. Select the **Active** tab to list all active groups. +1. Select the **Inactive** tab to list groups that are pending deletion. 1. To manage a group, find the group's row and select **Edit** or **Delete**. 1. Optional. To change the sort order, select the sort dropdown list and choose the desired order. The available sort options are: - - Created date (default). - - Updated date. - - Storage size. This option sorts groups by the total storage used, including Git repositories - and Large File Storage (LFS) for all projects in the group. For more information, see - [usage quotas](../user/storage_usage_quotas.md). + - Name + - Created date + - Updated date + - [Storage size](../user/storage_usage_quotas.md). -1. Optional. To search for groups by name, enter your criteria in the search field. The group search is - case-insensitive, and applies partial matching. +1. Optional. Enter at least 3 characters of the the group name you want to find to filter by name. 1. Optional. To [create a new group](../user/group/_index.md#create-a-group) select **New group**. ## Administering topics -- GitLab From cbc697e9191ad518c909f6d8ef79be1e14683503 Mon Sep 17 00:00:00 2001 From: Christina Lohr Date: Wed, 23 Jul 2025 17:36:50 +0200 Subject: [PATCH 2/7] Remove duplicate the --- doc/administration/admin_area.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/administration/admin_area.md b/doc/administration/admin_area.md index 576aa2cf1ef930..e3b801ce056a71 100644 --- a/doc/administration/admin_area.md +++ b/doc/administration/admin_area.md @@ -284,7 +284,7 @@ To administer all groups in the GitLab instance: - Updated date - [Storage size](../user/storage_usage_quotas.md). -1. Optional. Enter at least 3 characters of the the group name you want to find to filter by name. +1. Optional. Enter at least 3 characters of the group name you want to find to filter by name. 1. Optional. To [create a new group](../user/group/_index.md#create-a-group) select **New group**. ## Administering topics -- GitLab From 0044b42aef54449fc29895073de8cc7c679b50a7 Mon Sep 17 00:00:00 2001 From: Christina Lohr Date: Wed, 30 Jul 2025 13:47:46 +0200 Subject: [PATCH 3/7] Add history block and group actions --- doc/administration/admin_area.md | 39 +++++++++++++++++++++++++++++--- 1 file changed, 36 insertions(+), 3 deletions(-) diff --git a/doc/administration/admin_area.md b/doc/administration/admin_area.md index e3b801ce056a71..2ed8286627a668 100644 --- a/doc/administration/admin_area.md +++ b/doc/administration/admin_area.md @@ -260,6 +260,19 @@ It is also possible to limit which roles can ## Administering groups +{{< history >}} + +- New look [introduced](https://gitlab.com/groups/gitlab-org/-/epics/17783) in GitLab 18.2 [with a flag](feature_flags/_index.md) named `admin_groups_vue`. Disabled by default. + +{{< /history >}} + +{{< alert type="flag" >}} + +The availability of this feature is controlled by a feature flag. +For more information, see the history. + +{{< /alert >}} + To administer all groups in the GitLab instance: 1. On the left sidebar, at the bottom, select **Admin**. @@ -273,9 +286,11 @@ To administer all groups in the GitLab instance: - Number of projects - Member count -1. Select the **Active** tab to list all active groups. -1. Select the **Inactive** tab to list groups that are pending deletion. -1. To manage a group, find the group's row and select **Edit** or **Delete**. +1. Optional. Select a tab: + + - **Active** shows all active groups. + - **Inactive** shows groups that are pending deletion. + 1. Optional. To change the sort order, select the sort dropdown list and choose the desired order. The available sort options are: @@ -286,6 +301,24 @@ To administer all groups in the GitLab instance: 1. Optional. Enter at least 3 characters of the group name you want to find to filter by name. 1. Optional. To [create a new group](../user/group/_index.md#create-a-group) select **New group**. +### Edit a group + +To edit a group's name or description from the **Admin** area's Groups page: + +1. On the left sidebar, at the bottom, select **Admin**. +1. Select **Overview** > **Groups**. +1. Find the group you want to edit and select **Actions** ({{< icon name="ellipsis_v" >}}) > **Edit**. +1. Edit the **Group name** or **Group description**. +1. Select **Save Changes**. + +### Delete a group + +To delete a group: + +1. On the left sidebar, at the bottom, select **Admin**. +1. Select **Overview** > **Groups**. +1. Find the group you want to edit and select **Actions** ({{< icon name="ellipsis_v" >}}) > **Delete**. +1. On the confirmation dialog, select **Yes, delete group**. ## Administering topics -- GitLab From ab6421e8996331837c9bbaef7195aeda2d7eda14 Mon Sep 17 00:00:00 2001 From: Christina Lohr Date: Thu, 31 Jul 2025 13:22:40 +0200 Subject: [PATCH 4/7] Add group properties --- doc/administration/admin_area.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/doc/administration/admin_area.md b/doc/administration/admin_area.md index 2ed8286627a668..1efce424a2f534 100644 --- a/doc/administration/admin_area.md +++ b/doc/administration/admin_area.md @@ -281,6 +281,8 @@ To administer all groups in the GitLab instance: - Name - Description - Visibility level + - Role + - Status - Storage size - Number of subgroups - Number of projects -- GitLab From dcef8cc2ab77b2458a77e7b396eba8ea0d0b83a8 Mon Sep 17 00:00:00 2001 From: Christina Lohr Date: Thu, 31 Jul 2025 13:23:22 +0200 Subject: [PATCH 5/7] Add blank line to fix error --- doc/administration/admin_area.md | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/administration/admin_area.md b/doc/administration/admin_area.md index 1efce424a2f534..2a9ac34890485e 100644 --- a/doc/administration/admin_area.md +++ b/doc/administration/admin_area.md @@ -303,6 +303,7 @@ To administer all groups in the GitLab instance: 1. Optional. Enter at least 3 characters of the group name you want to find to filter by name. 1. Optional. To [create a new group](../user/group/_index.md#create-a-group) select **New group**. + ### Edit a group To edit a group's name or description from the **Admin** area's Groups page: -- GitLab From 4c24fdf87046e95d816389bb0f668574436c4c93 Mon Sep 17 00:00:00 2001 From: Peter Hegman Date: Tue, 5 Aug 2025 14:47:24 -0700 Subject: [PATCH 6/7] Update button title on confirmation modal --- doc/administration/admin_area.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/administration/admin_area.md b/doc/administration/admin_area.md index 2a9ac34890485e..c62d07c1ff7d85 100644 --- a/doc/administration/admin_area.md +++ b/doc/administration/admin_area.md @@ -321,7 +321,7 @@ To delete a group: 1. On the left sidebar, at the bottom, select **Admin**. 1. Select **Overview** > **Groups**. 1. Find the group you want to edit and select **Actions** ({{< icon name="ellipsis_v" >}}) > **Delete**. -1. On the confirmation dialog, select **Yes, delete group**. +1. On the confirmation dialog, select **Confirm**. ## Administering topics -- GitLab From 7286dbe0eb67cd20499975092fddecbf8cbb57e6 Mon Sep 17 00:00:00 2001 From: Phillip Wells Date: Wed, 6 Aug 2025 11:53:51 -0500 Subject: [PATCH 7/7] Apply 2 suggestion(s) to 1 file(s) --- doc/administration/admin_area.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/administration/admin_area.md b/doc/administration/admin_area.md index c62d07c1ff7d85..f4f07f513bc5ca 100644 --- a/doc/administration/admin_area.md +++ b/doc/administration/admin_area.md @@ -299,9 +299,9 @@ To administer all groups in the GitLab instance: - Name - Created date - Updated date - - [Storage size](../user/storage_usage_quotas.md). + - [Storage size](../user/storage_usage_quotas.md) -1. Optional. Enter at least 3 characters of the group name you want to find to filter by name. +1. Optional. To filter groups by name, in the search bar, enter at least three characters. 1. Optional. To [create a new group](../user/group/_index.md#create-a-group) select **New group**. ### Edit a group -- GitLab