CINXE.COM

<!DOCTYPE html> <html class="gl-light ui-red with-top-bar with-header " lang="en"> <head prefix="og: http://ogp.me/ns#"> <meta charset="utf-8"> <meta content="IE=edge" http-equiv="X-UA-Compatible"> <meta content="width=device-width, initial-scale=1" name="viewport"> <title>Index 路 Group 路 User 路 Help 路 GitLab</title> <script> //<![CDATA[ window.gon={};gon.api_version="v4";gon.default_avatar_url="https://gitlab.winehq.org/assets/no_avatar-849f9c04a3a0d0cea2424ae97b27447dc64a7dbfae83c036c45b403392f0e8ba.png";gon.max_file_size=10;gon.asset_host=null;gon.webpack_public_path="/assets/webpack/";gon.relative_url_root="";gon.user_color_mode="gl-light";gon.user_color_scheme="white";gon.markdown_surround_selection=null;gon.markdown_automatic_lists=null;gon.math_rendering_limits_enabled=true;gon.recaptcha_api_server_url="https://www.recaptcha.net/recaptcha/api.js";gon.recaptcha_sitekey="6LeicnYgAAAAAMX8j8CajLatGOq375vwTeO0X92E";gon.gitlab_url="https://gitlab.winehq.org";gon.promo_url="https://about.gitlab.com";gon.forum_url="https://forum.gitlab.com";gon.docs_url="https://docs.gitlab.com";gon.revision="ec90ea9eb29";gon.feature_category="not_owned";gon.gitlab_logo="/assets/gitlab_logo-2957169c8ef64c58616a1ac3f4fc626e8a35ce4eb3ed31bb0d873712f2a041a0.png";gon.secure=true;gon.sprite_icons="/assets/icons-8791a66659d025e0a4c801978c79a1fbd82db1d27d85f044a35728ea7cf0ae80.svg";gon.sprite_file_icons="/assets/file_icons/file_icons-7cd3d6c3b29a6d972895f36472978a4b5adb4b37f9b5d0716a380e82389f7e0e.svg";gon.emoji_sprites_css_path="/assets/emoji_sprites-d746ae2450a3e9c626d338d77a101b84ff33a47c0c281b676d75c4a6ed2948a4.css";gon.emoji_backend_version=4;gon.gridstack_css_path="/assets/lazy_bundles/gridstack-5fcfd4ffbea1db04eaf7f16521bcab19ae3af042c8b4afe8d16781eda5a70799.css";gon.test_env=false;gon.disable_animations=false;gon.suggested_label_colors={"#cc338b":"Magenta-pink","#dc143c":"Crimson","#c21e56":"Rose red","#cd5b45":"Dark coral","#ed9121":"Carrot orange","#eee600":"Titanium yellow","#009966":"Green-cyan","#8fbc8f":"Dark sea green","#6699cc":"Blue-gray","#e6e6fa":"Lavender","#9400d3":"Dark violet","#330066":"Deep violet","#36454f":"Charcoal grey","#808080":"Gray"};gon.first_day_of_week=0;gon.time_display_relative=true;gon.time_display_format=0;gon.ee=false;gon.jh=false;gon.dot_com=false;gon.uf_error_prefix="UF";gon.pat_prefix="glpat-";gon.keyboard_shortcuts_enabled=true;gon.diagramsnet_url="https://embed.diagrams.net";gon.features={"sourceEditorToolbar":false,"vscodeWebIde":true,"uiForOrganizations":false,"organizationSwitching":false,"findAndReplace":false,"removeMonitorMetrics":true,"workItemsViewPreference":false,"searchButtonTopRight":false}; //]]> </script> <link rel="stylesheet" href="/assets/application-2e69a08e74e113997b5ba7fc5cd3e020a6f407d9ad552675adc6d78c2b23d0f7.css" /> <link rel="stylesheet" href="/assets/page_bundles/commit_description-1e2cba4dda3c7b30dd84924809020c569f1308dea51520fe1dd5d4ce31403195.css" /><link rel="stylesheet" href="/assets/page_bundles/work_items-cbc6a2e1633c4e847a617e35cc4833b85b80816db688d3d6dd3cd31d4251bc53.css" /><link rel="stylesheet" href="/assets/page_bundles/notes_shared-caf98f77b75b4b5399bdde69c069ee023fefdaa986d687c937e8010218785f51.css" /> <link rel="stylesheet" href="/assets/application_utilities-0bfb919a8a7eb0e89544dfe328e69461ccb276a565685fdb6ae3b14f3db3f41b.css" /> <link rel="stylesheet" href="/assets/tailwind-016e83140c37d97dbdff0cef9c063fcd43d214866665fb783774776747928853.css" /> <link rel="stylesheet" href="/assets/fonts-fae5d3f79948bd85f18b6513a025f863b19636e85b09a1492907eb4b1bb0557b.css" /> <link rel="stylesheet" href="/assets/highlight/themes/white-5ffbb706faebead681b01c8b52e92c6c0d35ad5b1c11d39012c90bcaf7892ca8.css" /> <link rel="preload" href="/assets/application_utilities-0bfb919a8a7eb0e89544dfe328e69461ccb276a565685fdb6ae3b14f3db3f41b.css" as="style" type="text/css"> <link rel="preload" href="/assets/application-2e69a08e74e113997b5ba7fc5cd3e020a6f407d9ad552675adc6d78c2b23d0f7.css" as="style" type="text/css"> <link rel="preload" href="/assets/highlight/themes/white-5ffbb706faebead681b01c8b52e92c6c0d35ad5b1c11d39012c90bcaf7892ca8.css" as="style" type="text/css"> <script src="/assets/webpack/runtime.507390f4.bundle.js" defer="defer"></script> <script src="/assets/webpack/main.a4c9ae4f.chunk.js" defer="defer"></script> <script src="/assets/webpack/commons-pages.admin.abuse_reports.show-pages.admin.topics.edit-pages.admin.topics.new-pages.dashboar-c8f1318b.54872cef.chunk.js" defer="defer"></script> <script src="/assets/webpack/commons-pages.admin.abuse_reports.show-pages.dashboard.issues-pages.dashboard.milestones.show-pages.-13e11bbf.1a73330b.chunk.js" defer="defer"></script> <script src="/assets/webpack/commons-pages.admin.abuse_reports.show-pages.dashboard.issues-pages.groups.boards-pages.groups.issue-8dfa5f96.20262e8b.chunk.js" defer="defer"></script> <script src="/assets/webpack/commons-pages.admin.abuse_reports.show-pages.dashboard.issues-pages.groups.boards-pages.groups.issue-f804d6c2.d4f467df.chunk.js" defer="defer"></script> <script src="/assets/webpack/commons-pages.groups.new-pages.import.gitlab_projects.new-pages.import.manifest.new-pages.projects.n-44c6c18e.800b02b5.chunk.js" defer="defer"></script> <script src="/assets/webpack/commons-pages.search.show-super_sidebar.98a5daf8.chunk.js" defer="defer"></script> <script src="/assets/webpack/super_sidebar.839aed14.chunk.js" defer="defer"></script> <script src="/assets/webpack/default.700474e1.chunk.js" defer="defer"></script> <meta content="object" property="og:type"> <meta content="GitLab" property="og:site_name"> <meta content="Index 路 Group 路 User 路 Help 路 GitLab" property="og:title"> <meta content="WineHQ GitLab" property="og:description"> <meta content="https://gitlab.winehq.org/assets/twitter_card-570ddb06edf56a2312253c5872489847a0f385112ddbcd71ccfa1570febab5d2.jpg" property="og:image"> <meta content="64" property="og:image:width"> <meta content="64" property="og:image:height"> <meta content="https://gitlab.winehq.org/help/user/group/index.md" property="og:url"> <meta content="summary" property="twitter:card"> <meta content="Index 路 Group 路 User 路 Help 路 GitLab" property="twitter:title"> <meta content="WineHQ GitLab" property="twitter:description"> <meta content="https://gitlab.winehq.org/assets/twitter_card-570ddb06edf56a2312253c5872489847a0f385112ddbcd71ccfa1570febab5d2.jpg" property="twitter:image"> <meta name="csrf-param" content="authenticity_token" /> <meta name="csrf-token" content="7mKvxy51r2PcGhWETb7rDRn_TxepGi3e5xrmgdElJ2nm5po9jlgBGyxFHCGbKkdpKiE95906dJmRN7opbWu15g" /> <meta name="csp-nonce" /> <meta name="action-cable-url" content="/-/cable" /> <link href="/-/manifest.json" rel="manifest"> <link rel="icon" type="image/png" href="/uploads/-/system/appearance/favicon/1/wine-favicon.ico" id="favicon" data-original-href="/uploads/-/system/appearance/favicon/1/wine-favicon.ico" /> <link rel="apple-touch-icon" type="image/x-icon" href="/assets/apple-touch-icon-b049d4bc0dd9626f31db825d61880737befc7835982586d015bded10b4435460.png" /> <link href="/search/opensearch.xml" rel="search" title="Search GitLab" type="application/opensearchdescription+xml"> <meta content="WineHQ GitLab" name="description"> <meta content="#580d02" name="theme-color"> </head> <body class="tab-width-8 gl-browser-ie gl-platform-windows" data-page="help:show"> <script> //<![CDATA[ gl = window.gl || {}; gl.client = {"isIe":true,"isWindows":true}; //]]> </script> <header class="header-logged-out" data-testid="navbar"> <a class="gl-sr-only gl-accessibility" href="#content-body">Skip to content</a> <div class="container-fluid"> <nav aria-label="Explore GitLab" class="header-logged-out-nav gl-flex gl-gap-3 gl-justify-between"> <div class="gl-flex gl-items-center gl-gap-1"> <span class="gl-sr-only">GitLab</span> <a title="Homepage" id="logo" class="header-logged-out-logo has-tooltip" aria-label="Homepage" href="/"><img class="brand-header-logo lazy" alt="" data-src="/uploads/-/system/appearance/header_logo/1/winehq_logo_gitlab_small.png" src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" /> </a></div> <ul class="gl-list-none gl-p-0 gl-m-0 gl-flex gl-gap-3 gl-items-center gl-grow"> <li class="header-logged-out-nav-item"> <a class="" href="/explore">Explore</a> </li> </ul> <ul class="gl-list-none gl-p-0 gl-m-0 gl-flex gl-gap-3 gl-items-center gl-justify-end"> <li class="header-logged-out-nav-item"> <a href="/users/sign_in?redirect_to_referer=yes">Sign in</a> </li> <li class="header-logged-out-nav-item"> <a class="gl-button btn btn-md btn-confirm " href="/users/sign_up"><span class="gl-button-text"> Register </span> </a></li> </ul> </nav> </div> </header> <div class="layout-page page-with-super-sidebar"> <aside class="js-super-sidebar super-sidebar super-sidebar-loading" data-command-palette="{}" data-force-desktop-expanded-sidebar="true" data-is-saas="false" data-root-path="/" data-sidebar="{"is_logged_in":false,"context_switcher_links":[{"title":"Explore","link":"/explore","icon":"compass"}],"current_menu_items":[{"id":"projects_menu","title":"Projects","icon":"project","avatar_shape":"rect","link":"/explore/projects/starred","is_active":false,"items":[],"separated":false},{"id":"groups_menu","title":"Groups","icon":"group","avatar_shape":"rect","link":"/explore/groups","is_active":false,"items":[],"separated":false},{"id":"catalog_menu","title":"CI/CD Catalog","icon":"catalog-checkmark","avatar_shape":"rect","link":"/explore/catalog","is_active":false,"items":[],"separated":false},{"id":"topics_menu","title":"Topics","icon":"labels","avatar_shape":"rect","link":"/explore/projects/topics","is_active":false,"items":[],"separated":false},{"id":"snippets_menu","title":"Snippets","icon":"snippet","avatar_shape":"rect","link":"/explore/snippets","is_active":false,"items":[],"separated":false}],"current_context_header":"Explore","support_path":"https://about.gitlab.com/get-help/","docs_path":"/help/docs","display_whats_new":false,"show_version_check":null,"search":{"search_path":"/search","issues_path":"/dashboard/issues","mr_path":"/dashboard/merge_requests","autocomplete_path":"/search/autocomplete","settings_path":"/search/settings","search_context":{"for_snippets":null}},"panel_type":null,"shortcut_links":[{"title":"Snippets","href":"/explore/snippets","css_class":"dashboard-shortcuts-snippets"},{"title":"Groups","href":"/explore/groups","css_class":"dashboard-shortcuts-groups"},{"title":"Projects","href":"/explore/projects/starred","css_class":"dashboard-shortcuts-projects"}],"terms":null}"></aside> <div class="content-wrapper"> <div class="broadcast-wrapper"> </div> <div class="alert-wrapper alert-wrapper-top-space gl-flex gl-flex-col gl-gap-3 container-fluid container-limited"> <div class="gl-alert gl-alert-danger gl-alert-not-dismissible" role="alert"> <div class="gl-alert-icon-container"> <svg class="s16 gl-alert-icon gl-alert-icon-no-title" data-testid="error-icon"><use href="/assets/icons-8791a66659d025e0a4c801978c79a1fbd82db1d27d85f044a35728ea7cf0ae80.svg#error"></use></svg> </div> <div class="gl-alert-content" role="alert"> <div class="gl-alert-body"> GitLab may not work properly, because you are using an outdated web browser. <br> Please install a <a target="_blank" rel="noopener noreferrer" href="/help/install/requirements.md#supported-web-browsers">supported web browser</a> for a better experience. </div> </div> </div> </div> <div class="top-bar-fixed container-fluid" data-testid="top-bar"> <div class="top-bar-container gl-flex gl-items-center gl-gap-2"> <div class="gl-grow gl-basis-0 gl-flex gl-items-center gl-justify-start"> <button class="gl-button btn btn-icon btn-md btn-default btn-default-tertiary js-super-sidebar-toggle-expand super-sidebar-toggle -gl-ml-3" aria-controls="super-sidebar" aria-expanded="false" aria-label="Primary navigation sidebar" type="button"><svg class="s16 gl-icon gl-button-icon " data-testid="sidebar-icon"><use href="/assets/icons-8791a66659d025e0a4c801978c79a1fbd82db1d27d85f044a35728ea7cf0ae80.svg#sidebar"></use></svg> </button> <script type="application/ld+json"> {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Help","item":"https://gitlab.winehq.org/help"},{"@type":"ListItem","position":2,"name":"Help","item":"https://gitlab.winehq.org/help/user/group/index.md"}]} </script> <div data-testid="breadcrumb-links" id="js-vue-page-breadcrumbs-wrapper"> <div data-breadcrumbs-json="[{"text":"Help","href":"/help","avatarPath":null},{"text":"Help","href":"/help/user/group/index.md","avatarPath":null}]" id="js-vue-page-breadcrumbs"></div> <div id="js-injected-page-breadcrumbs"></div> </div> </div> <div class="gl-flex-none gl-flex gl-items-center gl-justify-center"> <div id="js-advanced-search-modal"></div> </div> <div class="gl-grow gl-basis-0 gl-flex gl-items-center gl-justify-end"> <div id="js-work-item-feedback"></div> </div> </div> </div> <div class="container-fluid container-limited limit-container-width"> <main class="content" id="content-body"> <div class="flash-container flash-container-page sticky" data-testid="flash-container"> <div id="js-global-alerts"></div> </div> <div class="md gl-text-lg gl-mt-3"> <h1 data-sourcepos="1:1-1:8" dir="auto">
<a href="#groups" aria-hidden="true" class="anchor" id="user-content-groups"></a>Groups</h1>
<p data-sourcepos="3:1-5:56" dir="auto">DETAILS:
<strong data-sourcepos="4:1-4:9">Tier:</strong> Free, Premium, Ultimate
<strong data-sourcepos="5:1-5:13">Offering:</strong> GitLab.com, Self-managed, GitLab Dedicated</p>
<p data-sourcepos="7:1-7:82" dir="auto">In GitLab, you use groups to manage one or more related projects at the same time.</p>
<p data-sourcepos="9:1-10:85" dir="auto">You can use groups to communicate with all group members and manage permissions for your projects.
If someone has access to the group, they get access to all the projects in the group.</p>
<p data-sourcepos="12:1-13:41" dir="auto">You can also view all of the issues and merge requests for the projects in the group,
and analytics about the group's activity.</p>
<p data-sourcepos="15:1-15:78" dir="auto">For larger organizations, you can also create <a data-sourcepos="15:47-15:77" href="subgroups/index.md">subgroups</a>.</p>
<p data-sourcepos="17:1-17:93" dir="auto">For more information about creating and managing your groups, see <a data-sourcepos="17:67-17:92" href="manage.md">Manage groups</a>.</p>
<h2 data-sourcepos="19:1-19:18" dir="auto">
<a href="#group-hierarchy" aria-hidden="true" class="anchor" id="user-content-group-hierarchy"></a>Group hierarchy</h2>
<p data-sourcepos="21:1-21:42" dir="auto">Groups are organized in a tree structure:</p>
<ul data-sourcepos="23:1-26:0" dir="auto">
<li data-sourcepos="23:1-23:185">A <strong data-sourcepos="23:5-23:23">top-level group</strong> is a group created at the "root" of the organization. An organization can have one or more top-level groups. A top-level group can contain one or more subgroups.</li>
<li data-sourcepos="24:1-24:68">A <strong data-sourcepos="24:5-24:20">parent group</strong> is a group that contains one or more subgroups.</li>
<li data-sourcepos="25:1-26:0">A <strong data-sourcepos="25:5-25:16">subgroup</strong> is a group that is part of another group.</li>
</ul>
<p data-sourcepos="27:1-27:38" dir="auto">For example, in the following diagram:</p>
<ul data-sourcepos="29:1-33:0" dir="auto">
<li data-sourcepos="29:1-29:131">The organization has four groups: one top-level group (T), which contains one subgroup (G), and two subgroups within G (A and B).</li>
<li data-sourcepos="30:1-30:51">T is a top-level group and the parent group of G.</li>
<li data-sourcepos="31:1-31:63">G is a subgroup (child) of T and the parent group of A and B.</li>
<li data-sourcepos="32:1-33:0">A and B are subgroups (children) of G.</li>
</ul>
<div class="gl-relative markdown-code-block js-markdown-code">
<pre data-sourcepos="34:1-45:3" data-canonical-lang="mermaid" class="code highlight js-syntax-highlight language-mermaid" v-pre="true"><code class="js-render-mermaid"><span id="LC1" class="line" lang="mermaid">%%{init: { "fontFamily": "GitLab Sans", 'theme':'neutral' }}%%</span>
<span id="LC2" class="line" lang="mermaid">flowchart TD</span>
<span id="LC3" class="line" lang="mermaid"> accTitle: Group hierarchy</span>
<span id="LC4" class="line" lang="mermaid"> accDescr: Example of a group hierarchy in an organization</span>
<span id="LC5" class="line" lang="mermaid"></span>
<span id="LC6" class="line" lang="mermaid"> subgraph Organization</span>
<span id="LC7" class="line" lang="mermaid"> T[Group T] --> G[Group G]</span>
<span id="LC8" class="line" lang="mermaid"> G --> A[Group A]</span>
<span id="LC9" class="line" lang="mermaid"> G --> B[Group B] </span>
<span id="LC10" class="line" lang="mermaid">end</span></code></pre>
<copy-code></copy-code><insert-code-snippet></insert-code-snippet>
</div>
<h2 data-sourcepos="47:1-47:18" dir="auto">
<a href="#group-structure" aria-hidden="true" class="anchor" id="user-content-group-structure"></a>Group structure</h2>
<p data-sourcepos="49:1-50:75" dir="auto">The way to set up a group depends on your use cases, team size, and access requirements.
The following table describes the most common models of structuring groups.</p>

<table data-sourcepos="54:1-59:217" dir="auto">
<thead>
<tr data-sourcepos="54:1-54:33">
<th data-sourcepos="54:2-54:8">Model</th>
<th data-sourcepos="54:10-54:20">Structure</th>
<th data-sourcepos="54:22-54:32">Use cases</th>
</tr>
</thead>
<tbody>
<tr data-sourcepos="56:1-56:189">
<td data-sourcepos="56:2-56:9">Simple</td>
<td data-sourcepos="56:11-56:44">One group for all your projects.</td>
<td data-sourcepos="56:46-56:188">Work in a small team or on specific solutions (for example, a marketing website) that require seamless collaboration and access to resources.</td>
</tr>
<tr data-sourcepos="57:1-57:255">
<td data-sourcepos="57:2-57:7">Team</td>
<td data-sourcepos="57:9-57:108">Different groups or subgroups for different types of teams (for example, product and engineering).</td>
<td data-sourcepos="57:110-57:254">Work in a large organization where some teams work autonomously or require centralized resources and limited access from external team members.</td>
</tr>
<tr data-sourcepos="58:1-58:139">
<td data-sourcepos="58:2-58:9">Client</td>
<td data-sourcepos="58:11-58:38">One group for each client.</td>
<td data-sourcepos="58:40-58:138">Provide custom solutions for multiple clients that require different resources and access levels.</td>
</tr>
<tr data-sourcepos="59:1-59:217">
<td data-sourcepos="59:2-59:16">Functionality</td>
<td data-sourcepos="59:18-59:92">One group or subgroup for one type of functionality (for example, AI/ML).</td>
<td data-sourcepos="59:94-59:216">Develop complex products where one functionality requires specific resources and collaboration of subject-matter experts.</td>
</tr>
</tbody>
</table>

<p data-sourcepos="63:1-71:67" dir="auto">NOTE:
On self-managed GitLab, if you want to see an overview of your entire organization, you should create one top-level group.
For more information about efforts to create an organization view of all groups,
<a data-sourcepos="66:1-66:66" href="https://gitlab.com/groups/gitlab-org/-/epics/9266" rel="nofollow noreferrer noopener" target="_blank">see epic 9266</a>.
A top-level group offers insights in your entire organization through a complete
<a data-sourcepos="68:1-68:84" href="../application_security/security_dashboard/index.md">Security Dashboard and Center</a>,
<a data-sourcepos="69:1-69:98" href="../application_security/vulnerability_report/index.md#vulnerability-report">Vulnerability Report</a>,
<a data-sourcepos="70:1-70:61" href="../compliance/compliance_center/index.md">compliance center</a>, and
<a data-sourcepos="71:1-71:66" href="../group/value_stream_analytics/index.md">value stream analytics</a>.</p>
<h2 data-sourcepos="73:1-73:19" dir="auto">
<a href="#group-visibility" aria-hidden="true" class="anchor" id="user-content-group-visibility"></a>Group visibility</h2>
<p data-sourcepos="75:1-75:58" dir="auto">Like projects, a group can be configured to be visible to:</p>
<ul data-sourcepos="77:1-80:0" dir="auto">
<li data-sourcepos="77:1-77:18">Anonymous users.</li>
<li data-sourcepos="78:1-78:26">All authenticated users.</li>
<li data-sourcepos="79:1-80:0">Only explicit group members.</li>
</ul>
<p data-sourcepos="81:1-83:70" dir="auto">The restriction for <a data-sourcepos="81:21-81:131" href="../../administration/settings/visibility_and_access_controls.md#restrict-visibility-levels">visibility levels</a>
on the application setting level also applies to groups. If set to internal, the explore page is
empty for anonymous users. The group page has a visibility level icon.</p>
<p data-sourcepos="85:1-86:27" dir="auto">Users cannot create a subgroup or project with a higher visibility level than that of
the immediate parent group.</p>
<h2 data-sourcepos="88:1-88:14" dir="auto">
<a href="#view-groups" aria-hidden="true" class="anchor" id="user-content-view-groups"></a>View groups</h2>
<p data-sourcepos="90:1-90:49" dir="auto">To explore all public groups you are a member of:</p>
<ol data-sourcepos="92:1-95:0" dir="auto">
<li data-sourcepos="92:1-92:51">On the left sidebar, select <strong data-sourcepos="92:32-92:50">Search or go to</strong>.</li>
<li data-sourcepos="93:1-93:33">Select <strong data-sourcepos="93:11-93:32">View all my groups</strong>.</li>
<li data-sourcepos="94:1-95:0">In the upper right, select <strong data-sourcepos="94:31-94:48">Explore groups</strong>.</li>
</ol>
<p data-sourcepos="96:1-96:60" dir="auto">To view groups where you have direct or indirect membership:</p>
<ol data-sourcepos="98:1-100:0" dir="auto">
<li data-sourcepos="98:1-98:51">On the left sidebar, select <strong data-sourcepos="98:32-98:50">Search or go to</strong>.</li>
<li data-sourcepos="99:1-100:0">Select <strong data-sourcepos="99:11-99:32">View all my groups</strong>.</li>
</ol>
<p data-sourcepos="101:1-101:56" dir="auto">This page shows groups that you are a member of through:</p>
<ul data-sourcepos="103:1-105:0" dir="auto">
<li data-sourcepos="103:1-103:42">Membership of a subgroup's parent group.</li>
<li data-sourcepos="104:1-105:0">Direct or inherited membership of a project in the group or subgroup.</li>
</ul>
<h2 data-sourcepos="106:1-106:15" dir="auto">
<a href="#view-a-group" aria-hidden="true" class="anchor" id="user-content-view-a-group"></a>View a group</h2>
<p data-sourcepos="108:1-108:111" dir="auto">The group overview page displays information about the group and its members, subgroups, and projects, such as:</p>
<ul data-sourcepos="110:1-117:0" dir="auto">
<li data-sourcepos="110:1-110:19">Group description</li>
<li data-sourcepos="111:1-111:17">Recent activity</li>
<li data-sourcepos="112:1-112:45">Number of merge requests and issues created</li>
<li data-sourcepos="113:1-113:25">Number of members added</li>
<li data-sourcepos="114:1-114:24">Subgroups and projects</li>
<li data-sourcepos="115:1-115:17">Shared projects</li>
<li data-sourcepos="116:1-117:0">Archived projects</li>
</ul>
<p data-sourcepos="118:1-118:16" dir="auto">To view a group:</p>
<ul data-sourcepos="120:1-121:0" dir="auto">
<li data-sourcepos="120:1-121:0">On the left sidebar, select <strong data-sourcepos="120:31-120:49">Search or go to</strong> and find your group.</li>
</ul>
<p data-sourcepos="122:1-123:47" dir="auto">You can search for the subgroups and projects of the group
and sort them in ascending or descending order.</p>
<h2 data-sourcepos="125:1-125:22" dir="auto">
<a href="#view-group-activity" aria-hidden="true" class="anchor" id="user-content-view-group-activity"></a>View group activity</h2>
<p data-sourcepos="127:1-127:32" dir="auto">To view the activity of a group:</p>
<ol data-sourcepos="129:1-141:0" dir="auto">
<li data-sourcepos="129:1-129:71">
<p data-sourcepos="129:4-129:71">On the left sidebar, select <strong data-sourcepos="129:32-129:50">Search or go to</strong> and find your group.</p>
</li>
<li data-sourcepos="130:1-130:32">
<p data-sourcepos="130:4-130:32">Select <strong data-sourcepos="130:11-130:31">Manage > Activity</strong>.</p>
</li>
<li data-sourcepos="131:1-141:0">
<p data-sourcepos="131:4-131:67">Optional. To filter activity by contribution type, select a tab:</p>
<ul data-sourcepos="133:4-141:0">
<li data-sourcepos="133:4-133:83">
<strong data-sourcepos="133:6-133:12">All</strong>: All contributions by group members in the group and group's projects.</li>
<li data-sourcepos="134:4-134:58">
<strong data-sourcepos="134:6-134:20">Push events</strong>: Push events in the group's projects.</li>
<li data-sourcepos="135:4-135:71">
<strong data-sourcepos="135:6-135:21">Merge events</strong>: Accepted merge requests in the group's projects.</li>
<li data-sourcepos="136:4-136:72">
<strong data-sourcepos="136:6-136:21">Issue events</strong>: Issues opened and closed in the group's projects.</li>
<li data-sourcepos="137:4-137:76">
<strong data-sourcepos="137:6-137:17">Comments</strong>: Comments posted by group members in the group's projects.</li>
<li data-sourcepos="138:4-138:50">
<strong data-sourcepos="138:6-138:13">Wiki</strong>: Updates to wiki pages in the group.</li>
<li data-sourcepos="139:4-139:78">
<strong data-sourcepos="139:6-139:16">Designs</strong>: Designs added, updated, and removed in the group's projects.</li>
<li data-sourcepos="140:4-141:0">
<strong data-sourcepos="140:6-140:13">Team</strong>: Group members who joined and left the group's projects.</li>
</ul>
</li>
</ol>
<h3 data-sourcepos="142:1-142:40" dir="auto">
<a href="#access-a-group-by-using-the-group-id" aria-hidden="true" class="anchor" id="user-content-access-a-group-by-using-the-group-id"></a>Access a group by using the group ID</h3>
<blockquote data-sourcepos="144:1-144:94" dir="auto">
<ul data-sourcepos="144:3-144:94">
<li data-sourcepos="144:3-144:94">
<a data-sourcepos="144:5-144:78" href="https://gitlab.com/gitlab-org/gitlab/-/merge_requests/165889" rel="nofollow noreferrer noopener" target="_blank">Introduced</a> in GitLab 17.5.</li>
</ul>
</blockquote>
<p data-sourcepos="146:1-148:86" dir="auto">You can access a group by using its ID instead of its name at <code data-sourcepos="146:64-146:98">https://gitlab.example.com/-/g/<id></code>.
For example, if your group <code data-sourcepos="147:29-147:41">example-group</code> has an ID <code data-sourcepos="147:55-147:60">123456</code>, you can access the group either at
<code data-sourcepos="148:2-148:41">https://gitlab.example.com/example-group</code> or <code data-sourcepos="148:48-148:84">https://gitlab.example.com/-/g/123456</code>.</p>
<p data-sourcepos="150:1-150:103" dir="auto">You might need the group ID if you want to interact with it using the <a data-sourcepos="150:71-150:102" href="../../api/index.md">GitLab API</a>.</p>
<p data-sourcepos="152:1-152:21" dir="auto">To copy the Group ID:</p>
<ol data-sourcepos="154:1-157:0" dir="auto">
<li data-sourcepos="154:1-154:71">On the left sidebar, select <strong data-sourcepos="154:32-154:50">Search or go to</strong> and find your Group.</li>
<li data-sourcepos="155:1-155:96">On the Group overview page, in the upper-right corner, select <strong data-sourcepos="155:66-155:76">Actions</strong> (<strong data-sourcepos="155:79-155:94">{ellipsis_v}</strong>).</li>
<li data-sourcepos="156:1-157:0">Select <strong data-sourcepos="156:11-156:27">Copy Group ID</strong>.</li>
</ol>
<h2 data-sourcepos="158:1-158:17" dir="auto">
<a href="#create-a-group" aria-hidden="true" class="anchor" id="user-content-create-a-group"></a>Create a group</h2>
<p data-sourcepos="160:1-160:18" dir="auto">To create a group:</p>

<ol data-sourcepos="164:1-176:0" dir="auto">
<li data-sourcepos="164:1-164:89">On the left sidebar, at the top, select <strong data-sourcepos="164:44-164:57">Create new</strong> (<strong data-sourcepos="164:60-164:69">{plus}</strong>) and <strong data-sourcepos="164:76-164:88">New group</strong>.</li>
<li data-sourcepos="165:1-165:27">Select <strong data-sourcepos="165:11-165:26">Create group</strong>.</li>
<li data-sourcepos="166:1-167:42">In the <strong data-sourcepos="166:11-166:24">Group name</strong> text box, enter the name of the group. For a list of words that cannot be used as group names, see
<a data-sourcepos="167:4-167:41" href="../reserved_names.md">reserved names</a>.</li>
<li data-sourcepos="168:1-168:111">In the <strong data-sourcepos="168:11-168:23">Group URL</strong> text box, enter the path for the group used for the <a data-sourcepos="168:77-168:110" href="../namespace/index.md">namespace</a>.</li>
<li data-sourcepos="169:1-169:71">Select the <a data-sourcepos="169:15-169:57" href="../public_access.md"><strong data-sourcepos="169:16-169:35">Visibility level</strong></a> of the group.</li>
<li data-sourcepos="170:1-173:84">Optional. To personalize your GitLab experience:
<ul data-sourcepos="171:4-173:84">
<li data-sourcepos="171:4-171:55">From the <strong data-sourcepos="171:15-171:22">Role</strong> dropdown list, select your role.</li>
<li data-sourcepos="172:4-172:61">For <strong data-sourcepos="172:10-172:42">Who will be using this group?</strong>, select an option.</li>
<li data-sourcepos="173:4-173:84">From the <strong data-sourcepos="173:15-173:51">What will you use this group for?</strong> dropdown list, select an option.</li>
</ul>
</li>
<li data-sourcepos="174:1-174:220">Optional. To invite members to the group, in the <strong data-sourcepos="174:53-174:63">Email 1</strong> text box, enter the email address of the user you want to invite. To invite more users, select <strong data-sourcepos="174:160-174:184">Invite another member</strong> and enter the user's email address.</li>
<li data-sourcepos="175:1-176:0">Select <strong data-sourcepos="175:11-175:26">Create group</strong>.</li>
</ol>

<p data-sourcepos="179:1-180:112" dir="auto"><i aria-hidden="true"></i>
For details about groups, watch <a data-sourcepos="180:33-180:111" href="https://youtu.be/r0sJgjR2f5A" rel="nofollow noreferrer noopener" target="_blank">GitLab Namespaces (users, groups and subgroups)</a>.</p>
<h2 data-sourcepos="182:1-182:43" dir="auto">
<a href="#edit-group-name-description-and-avatar" aria-hidden="true" class="anchor" id="user-content-edit-group-name-description-and-avatar"></a>Edit group name, description, and avatar</h2>
<p data-sourcepos="184:1-184:64" dir="auto">You can edit your group details from the group general settings.</p>
<p data-sourcepos="186:1-186:14" dir="auto">Prerequisites:</p>
<ul data-sourcepos="188:1-189:0" dir="auto">
<li data-sourcepos="188:1-189:0">You must have the Owner role for the group.</li>
</ul>
<p data-sourcepos="190:1-190:22" dir="auto">To edit group details:</p>
<ol data-sourcepos="192:1-199:0" dir="auto">
<li data-sourcepos="192:1-192:71">On the left sidebar, select <strong data-sourcepos="192:32-192:50">Search or go to</strong> and find your group.</li>
<li data-sourcepos="193:1-193:33">Select <strong data-sourcepos="193:11-193:32">Settings > General</strong>.</li>
<li data-sourcepos="194:1-194:125">In the <strong data-sourcepos="194:11-194:24">Group name</strong> text box, enter your group name. See the <a data-sourcepos="194:67-194:124" href="../../user/reserved_names.md">limitations on group names</a>.</li>
<li data-sourcepos="195:1-196:48">Optional. In the <strong data-sourcepos="195:21-195:52">Group description (optional)</strong> text box, enter your group description.
The description is limited to 500 characters.</li>
<li data-sourcepos="197:1-197:169">Optional. Under <strong data-sourcepos="197:20-197:35">Group avatar</strong>, select <strong data-sourcepos="197:45-197:59">Choose file</strong>, then select an image. The ideal image size is 192 x 192 pixels, and the maximum file size allowed is 200 KB.</li>
<li data-sourcepos="198:1-199:0">Select <strong data-sourcepos="198:11-198:26">Save changes</strong>.</li>
</ol>
<h2 data-sourcepos="200:1-200:16" dir="auto">
<a href="#leave-a-group" aria-hidden="true" class="anchor" id="user-content-leave-a-group"></a>Leave a group</h2>
<blockquote data-sourcepos="202:1-202:129" dir="auto">
<ul data-sourcepos="202:3-202:129">
<li data-sourcepos="202:3-202:129">The button to leave a group <a data-sourcepos="202:33-202:93" href="https://gitlab.com/gitlab-org/gitlab/-/issues/431539" rel="nofollow noreferrer noopener" target="_blank">moved</a> to the Actions menu in GitLab 16.7.</li>
</ul>
</blockquote>
<p data-sourcepos="204:1-204:23" dir="auto">When you leave a group:</p>
<ul data-sourcepos="206:1-208:0" dir="auto">
<li data-sourcepos="206:1-206:94">You are no longer a member of the group, its subgroups, and projects, and cannot contribute.</li>
<li data-sourcepos="207:1-208:0">All the issues and merge requests that were assigned to you are unassigned.</li>
</ul>
<p data-sourcepos="209:1-209:17" dir="auto">To leave a group:</p>
<ol data-sourcepos="211:1-214:0" dir="auto">
<li data-sourcepos="211:1-211:71">On the left sidebar, select <strong data-sourcepos="211:32-211:50">Search or go to</strong> and find your group.</li>
<li data-sourcepos="212:1-212:96">On the group overview page, in the upper-right corner, select <strong data-sourcepos="212:66-212:76">Actions</strong> (<strong data-sourcepos="212:79-212:95">{ellipsis_v})</strong>.</li>
<li data-sourcepos="213:1-214:0">Select <strong data-sourcepos="213:11-213:25">Leave group</strong>, then <strong data-sourcepos="213:33-213:47">Leave group</strong> again.</li>
</ol>
<h2 data-sourcepos="215:1-215:17" dir="auto">
<a href="#delete-a-group" aria-hidden="true" class="anchor" id="user-content-delete-a-group"></a>Delete a group</h2>
<blockquote data-sourcepos="217:1-217:254" dir="auto">
<ul data-sourcepos="217:3-217:254">
<li data-sourcepos="217:3-217:254">Enabled delayed deletion by default and removed the option to delete immediately <a data-sourcepos="217:86-217:154" href="https://gitlab.com/gitlab-org/gitlab/-/issues/393622" rel="nofollow noreferrer noopener" target="_blank">on GitLab.com</a> and <a data-sourcepos="217:160-217:238" href="https://gitlab.com/gitlab-org/gitlab/-/merge_requests/119606" rel="nofollow noreferrer noopener" target="_blank">on self-managed</a> in GitLab 16.0.</li>
</ul>
</blockquote>
<p data-sourcepos="219:1-219:35" dir="auto">To delete a group and its contents:</p>
<ol data-sourcepos="221:1-226:0" dir="auto">
<li data-sourcepos="221:1-221:71">On the left sidebar, select <strong data-sourcepos="221:32-221:50">Search or go to</strong> and find your group.</li>
<li data-sourcepos="222:1-222:33">Select <strong data-sourcepos="222:11-222:32">Settings > General</strong>.</li>
<li data-sourcepos="223:1-223:35">Expand the <strong data-sourcepos="223:15-223:26">Advanced</strong> section.</li>
<li data-sourcepos="224:1-224:60">In the <strong data-sourcepos="224:11-224:26">Delete group</strong> section, select <strong data-sourcepos="224:44-224:59">Delete group</strong>.</li>
<li data-sourcepos="225:1-226:0">On the confirmation dialog, type the group name and select <strong data-sourcepos="225:63-225:73">Confirm</strong>.</li>
</ol>
<p data-sourcepos="227:1-227:54" dir="auto">You can also delete a group from the groups dashboard:</p>
<ol data-sourcepos="229:1-235:0" dir="auto">
<li data-sourcepos="229:1-229:51">On the left sidebar, select <strong data-sourcepos="229:32-229:50">Search or go to</strong>.</li>
<li data-sourcepos="230:1-230:33">Select <strong data-sourcepos="230:11-230:32">View all my groups</strong>.</li>
<li data-sourcepos="231:1-231:62">Select (<strong data-sourcepos="231:12-231:27">{ellipsis_v}</strong>) for the group you want to delete.</li>
<li data-sourcepos="232:1-232:21">Select <strong data-sourcepos="232:11-232:20">Delete</strong>.</li>
<li data-sourcepos="233:1-233:60">In the <strong data-sourcepos="233:11-233:26">Delete group</strong> section, select <strong data-sourcepos="233:44-233:59">Delete group</strong>.</li>
<li data-sourcepos="234:1-235:0">On the confirmation dialog, type the group name and select <strong data-sourcepos="234:63-234:73">Confirm</strong>.</li>
</ol>
<p data-sourcepos="236:1-236:410" dir="auto">On GitLab <a data-sourcepos="236:11-236:62" href="https://about.gitlab.com/pricing/premium/" rel="nofollow noreferrer noopener" target="_blank">Premium</a> and <a data-sourcepos="236:68-236:121" href="https://about.gitlab.com/pricing/ultimate/" rel="nofollow noreferrer noopener" target="_blank">Ultimate</a>, this action adds a background job to mark a group for deletion. By default, the job schedules the deletion seven days in the future. You can modify this retention period through the <a data-sourcepos="236:306-236:409" href="../../administration/settings/visibility_and_access_controls.md#deletion-protection">instance settings</a>.</p>
<p data-sourcepos="238:1-239:117" dir="auto">If the user who scheduled the group deletion loses access to the group (for example, by leaving the group, having their role downgraded, or being banned from the group) before the deletion occurs,
the deletion job will instead restore and unarchive the group, so the group will no longer be scheduled for deletion.</p>
<p data-sourcepos="241:4-242:155" dir="auto">WARNING:
If the user who scheduled the group deletion regains Owner role or administrator access before the job runs, then the job removes the group permanently.</p>
<h3 data-sourcepos="244:1-244:32" dir="auto">
<a href="#view-groups-pending-deletion" aria-hidden="true" class="anchor" id="user-content-view-groups-pending-deletion"></a>View groups pending deletion</h3>
<p data-sourcepos="246:1-248:56" dir="auto">DETAILS:
<strong data-sourcepos="247:1-247:9">Tier:</strong> Premium, Ultimate
<strong data-sourcepos="248:1-248:13">Offering:</strong> GitLab.com, Self-managed, GitLab Dedicated</p>
<p data-sourcepos="250:1-250:69" dir="auto">To view a list of the subgroups that are pending deletion in a group:</p>
<ol data-sourcepos="252:1-254:0" dir="auto">
<li data-sourcepos="252:1-252:71">On the left sidebar, select <strong data-sourcepos="252:32-252:50">Search or go to</strong> and find your group.</li>
<li data-sourcepos="253:1-254:0">Select <strong data-sourcepos="253:11-253:36">Subgroups and projects</strong>.</li>
</ol>
<p data-sourcepos="255:1-255:69" dir="auto">Groups that are marked for deletion are labeled <strong data-sourcepos="255:49-255:68">Pending deletion</strong>.</p>
<h2 data-sourcepos="257:1-257:29" dir="auto">
<a href="#delete-a-group-immediately" aria-hidden="true" class="anchor" id="user-content-delete-a-group-immediately"></a>Delete a group immediately</h2>
<p data-sourcepos="259:1-261:56" dir="auto">DETAILS:
<strong data-sourcepos="260:1-260:9">Tier:</strong> Premium, Ultimate
<strong data-sourcepos="261:1-261:13">Offering:</strong> GitLab.com, Self-managed, GitLab Dedicated</p>
<blockquote data-sourcepos="263:1-263:254" dir="auto">
<ul data-sourcepos="263:3-263:254">
<li data-sourcepos="263:3-263:254">Enabled delayed deletion by default and removed the option to delete immediately <a data-sourcepos="263:86-263:154" href="https://gitlab.com/gitlab-org/gitlab/-/issues/393622" rel="nofollow noreferrer noopener" target="_blank">on GitLab.com</a> and <a data-sourcepos="263:160-263:238" href="https://gitlab.com/gitlab-org/gitlab/-/merge_requests/119606" rel="nofollow noreferrer noopener" target="_blank">on self-managed</a> in GitLab 16.0.</li>
</ul>
</blockquote>
<p data-sourcepos="265:1-265:62" dir="auto">If you don't want to wait, you can delete a group immediately.</p>
<p data-sourcepos="267:1-267:14" dir="auto">Prerequisites:</p>
<ul data-sourcepos="269:1-271:0" dir="auto">
<li data-sourcepos="269:1-269:43">You must have the Owner role for a group.</li>
<li data-sourcepos="270:1-271:0">You have <a data-sourcepos="270:12-270:59" href="#delete-a-group">marked the group for deletion</a>.</li>
</ul>
<p data-sourcepos="272:1-272:50" dir="auto">To immediately delete a group marked for deletion:</p>
<ol data-sourcepos="274:1-279:0" dir="auto">
<li data-sourcepos="274:1-274:71">On the left sidebar, select <strong data-sourcepos="274:32-274:50">Search or go to</strong> and find your group.</li>
<li data-sourcepos="275:1-275:33">Select <strong data-sourcepos="275:11-275:32">Settings > General</strong>.</li>
<li data-sourcepos="276:1-276:23">Expand <strong data-sourcepos="276:11-276:22">Advanced</strong>.</li>
<li data-sourcepos="277:1-277:72">In the <strong data-sourcepos="277:11-277:38">Permanently delete group</strong> section, select <strong data-sourcepos="277:56-277:71">Delete group</strong>.</li>
<li data-sourcepos="278:1-279:0">Confirm the action when asked to.</li>
</ol>
<p data-sourcepos="280:1-280:119" dir="auto">This action deletes the group, its subgroups, projects, and all related resources, including issues and merge requests.</p>
<h2 data-sourcepos="282:1-282:18" dir="auto">
<a href="#restore-a-group" aria-hidden="true" class="anchor" id="user-content-restore-a-group"></a>Restore a group</h2>
<p data-sourcepos="284:1-286:56" dir="auto">DETAILS:
<strong data-sourcepos="285:1-285:9">Tier:</strong> Premium, Ultimate
<strong data-sourcepos="286:1-286:13">Offering:</strong> GitLab.com, Self-managed, GitLab Dedicated</p>
<p data-sourcepos="288:1-288:47" dir="auto">To restore a group that is marked for deletion:</p>
<ol data-sourcepos="290:1-294:0" dir="auto">
<li data-sourcepos="290:1-290:71">On the left sidebar, select <strong data-sourcepos="290:32-290:50">Search or go to</strong> and find your group.</li>
<li data-sourcepos="291:1-291:33">Select <strong data-sourcepos="291:11-291:32">Settings > General</strong>.</li>
<li data-sourcepos="292:1-292:35">Expand the <strong data-sourcepos="292:15-292:26">Advanced</strong> section.</li>
<li data-sourcepos="293:1-294:0">In the <strong data-sourcepos="293:11-293:27">Restore group</strong> section, select <strong data-sourcepos="293:45-293:61">Restore group</strong>.</li>
</ol>
<h2 data-sourcepos="295:1-295:28" dir="auto">
<a href="#request-access-to-a-group" aria-hidden="true" class="anchor" id="user-content-request-access-to-a-group"></a>Request access to a group</h2>
<p data-sourcepos="297:1-297:84" dir="auto">As a user, you can request to be a member of a group, if an administrator allows it.</p>
<ol data-sourcepos="299:1-305:0" dir="auto">
<li data-sourcepos="299:1-299:51">On the left sidebar, select <strong data-sourcepos="299:32-299:50">Search or go to</strong>.</li>
<li data-sourcepos="300:1-300:33">Select <strong data-sourcepos="300:11-300:32">View all my groups</strong>.</li>
<li data-sourcepos="301:1-301:49">In the upper right, select <strong data-sourcepos="301:31-301:48">Explore groups</strong>.</li>
<li data-sourcepos="302:1-302:84">In the <strong data-sourcepos="302:11-302:28">Search by name</strong> text box, enter the name of the group you want to join.</li>
<li data-sourcepos="303:1-303:55">In the search results, select the name of the group.</li>
<li data-sourcepos="304:1-305:0">On the group page, under the group name, select <strong data-sourcepos="304:52-304:69">Request Access</strong>.</li>
</ol>
<p data-sourcepos="306:1-307:51" dir="auto">Up to ten of the most recently active group owners receive an email with your request.
Any group owner can approve or decline the request.</p>
<p data-sourcepos="309:1-310:28" dir="auto">If you change your mind before your request is approved, select
<strong data-sourcepos="310:1-310:27">Withdraw Access Request</strong>.</p>
<h2 data-sourcepos="312:1-312:21" dir="auto">
<a href="#view-group-members" aria-hidden="true" class="anchor" id="user-content-view-group-members"></a>View group members</h2>
<p data-sourcepos="314:1-314:27" dir="auto">To view members of a group:</p>
<ol data-sourcepos="316:1-318:0" dir="auto">
<li data-sourcepos="316:1-316:71">On the left sidebar, select <strong data-sourcepos="316:32-316:50">Search or go to</strong> and find your group.</li>
<li data-sourcepos="317:1-318:0">Select <strong data-sourcepos="317:11-317:30">Manage > Members</strong>.</li>
</ol>
<p data-sourcepos="319:1-319:30" dir="auto">A table displays the member's:</p>
<ul data-sourcepos="321:1-331:0" dir="auto">
<li data-sourcepos="321:1-321:32">
<strong data-sourcepos="321:3-321:13">Account</strong> name and username.</li>
<li data-sourcepos="322:1-327:56">
<strong data-sourcepos="322:3-322:12">Source</strong> of their <a data-sourcepos="322:23-322:80" href="../project/members/index.md#membership-types">membership</a>.
For transparency, GitLab displays all membership sources of group members.
Members who have multiple membership sources are displayed and counted as separate members.
For example, if a member has been added to the group both directly and through inheritance,
the member is displayed twice in the <strong data-sourcepos="326:40-326:50">Members</strong> table, with different sources,
and is counted as two individual members of the group.</li>
<li data-sourcepos="328:1-328:82">
<a data-sourcepos="328:3-328:68" href="../project/members/index.md#which-roles-you-can-assign"><strong data-sourcepos="328:4-328:11">Role</strong></a> in the group.</li>
<li data-sourcepos="329:1-329:48">
<strong data-sourcepos="329:3-329:16">Expiration</strong> date of their group membership.</li>
<li data-sourcepos="330:1-331:0">
<strong data-sourcepos="330:3-330:14">Activity</strong> related to their account.</li>
</ul>
<p data-sourcepos="332:1-334:93" dir="auto">NOTE:
The display of group members' <strong data-sourcepos="333:31-333:40">Source</strong> might be inconsistent.
For more information, see <a data-sourcepos="334:27-334:92" href="https://gitlab.com/gitlab-org/gitlab/-/issues/23020" rel="nofollow noreferrer noopener" target="_blank">issue 23020</a>.</p>
<p data-sourcepos="336:1-336:187" dir="auto">To view all namespace members (and their respective occupied seats), in the top-level namespace, <a data-sourcepos="336:98-336:186" href="../../subscriptions/gitlab_com/index.md#view-seat-usage">view the <strong data-sourcepos="336:108-336:123">Usage Quotas</strong> page</a>.</p>
<h2 data-sourcepos="338:1-338:37" dir="auto">
<a href="#filter-and-sort-members-in-a-group" aria-hidden="true" class="anchor" id="user-content-filter-and-sort-members-in-a-group"></a>Filter and sort members in a group</h2>
<p data-sourcepos="340:1-340:60" dir="auto">To find members in a group, you can sort, filter, or search.</p>
<h3 data-sourcepos="342:1-342:18" dir="auto">
<a href="#filter-a-group" aria-hidden="true" class="anchor" id="user-content-filter-a-group"></a>Filter a group</h3>
<p data-sourcepos="344:1-344:97" dir="auto">Filter a group to find members. By default, all members in the group and subgroups are displayed.</p>
<p data-sourcepos="346:1-346:68" dir="auto">In lists of group members, entries can display the following badges:</p>
<ul data-sourcepos="348:1-350:0" dir="auto">
<li data-sourcepos="348:1-348:93">
<strong data-sourcepos="348:3-348:10">SAML</strong>, to indicate the member has a <a data-sourcepos="348:42-348:74" href="saml_sso/index.md">SAML account</a> connected to them.</li>
<li data-sourcepos="349:1-350:0">
<strong data-sourcepos="349:3-349:16">Enterprise</strong>, to indicate that the member of the top-level group is an <a data-sourcepos="349:76-349:121" href="../enterprise_user/index.md">enterprise user</a>.</li>
</ul>
<ol data-sourcepos="351:1-358:0" dir="auto">
<li data-sourcepos="351:1-351:71">On the left sidebar, select <strong data-sourcepos="351:32-351:50">Search or go to</strong> and find your group.</li>
<li data-sourcepos="352:1-352:31">Select <strong data-sourcepos="352:11-352:30">Manage > Members</strong>.</li>
<li data-sourcepos="353:1-358:0">Above the list of members, in the <strong data-sourcepos="353:38-353:55">Filter members</strong> text box, enter your search criteria. To view:
<ul data-sourcepos="354:4-358:0">
<li data-sourcepos="354:4-354:65">Direct members of the group, select <strong data-sourcepos="354:42-354:64">Membership = Direct</strong>.</li>
<li data-sourcepos="355:4-355:100">Inherited, shared, and inherited shared members of the group, select <strong data-sourcepos="355:75-355:99">Membership = Indirect</strong>.</li>
<li data-sourcepos="356:4-356:112">Members with two-factor authentication enabled or disabled, select <strong data-sourcepos="356:73-356:89">2FA = Enabled</strong> or <strong data-sourcepos="356:94-356:111">2FA = Disabled</strong>.</li>
<li data-sourcepos="357:4-358:0">Members of the top-level group who are <a data-sourcepos="357:45-357:91" href="../enterprise_user/index.md">enterprise users</a>, select <strong data-sourcepos="357:101-357:121">Enterprise = true</strong>.</li>
</ul>
</li>
</ol>
<h3 data-sourcepos="359:1-359:18" dir="auto">
<a href="#search-a-group" aria-hidden="true" class="anchor" id="user-content-search-a-group"></a>Search a group</h3>
<p data-sourcepos="361:1-361:107" dir="auto">You can search for members by name, username, or <a data-sourcepos="361:50-361:106" href="../profile/index.md#set-your-public-email">public email</a>.</p>
<ol data-sourcepos="363:1-367:0" dir="auto">
<li data-sourcepos="363:1-363:71">On the left sidebar, select <strong data-sourcepos="363:32-363:50">Search or go to</strong> and find your group.</li>
<li data-sourcepos="364:1-364:31">Select <strong data-sourcepos="364:11-364:30">Manage > Members</strong>.</li>
<li data-sourcepos="365:1-365:83">Above the list of members, in the <strong data-sourcepos="365:38-365:55">Filter members</strong> box, enter search criteria.</li>
<li data-sourcepos="366:1-367:0">To the right of the <strong data-sourcepos="366:24-366:41">Filter members</strong> box, select the magnifying glass (<strong data-sourcepos="366:77-366:88">{search}</strong>).</li>
</ol>
<h3 data-sourcepos="368:1-368:27" dir="auto">
<a href="#sort-members-in-a-group" aria-hidden="true" class="anchor" id="user-content-sort-members-in-a-group"></a>Sort members in a group</h3>
<p data-sourcepos="370:1-370:87" dir="auto">You can sort members by <strong data-sourcepos="370:25-370:35">Account</strong>, <strong data-sourcepos="370:38-370:55">Access granted</strong>, <strong data-sourcepos="370:58-370:65">Role</strong>, or <strong data-sourcepos="370:71-370:86">Last sign-in</strong>.</p>
<ol data-sourcepos="372:1-378:0" dir="auto">
<li data-sourcepos="372:1-372:71">On the left sidebar, select <strong data-sourcepos="372:32-372:50">Search or go to</strong> and find your group.</li>
<li data-sourcepos="373:1-373:31">Select <strong data-sourcepos="373:11-373:30">Manage > Members</strong>.</li>
<li data-sourcepos="374:1-375:29">Above the list of members, in the upper-right corner, from the <strong data-sourcepos="374:67-374:77">Account</strong> list, select
the criteria to filter by.</li>
<li data-sourcepos="376:1-378:0">To switch the sort between ascending and descending, to the right of the <strong data-sourcepos="376:77-376:87">Account</strong> list, select the
arrow (<strong data-sourcepos="377:11-377:27">{sort-lowest}</strong> or <strong data-sourcepos="377:32-377:49">{sort-highest}</strong>).</li>
</ol>
<h2 data-sourcepos="379:1-379:23" dir="auto">
<a href="#add-users-to-a-group" aria-hidden="true" class="anchor" id="user-content-add-users-to-a-group"></a>Add users to a group</h2>
<blockquote data-sourcepos="381:1-382:151" dir="auto">
<ul data-sourcepos="381:3-382:151">
<li data-sourcepos="381:3-381:120">Expiring access email notification <a data-sourcepos="381:40-381:104" href="https://gitlab.com/gitlab-org/gitlab/-/issues/12704" rel="nofollow noreferrer noopener" target="_blank">introduced</a> in GitLab 16.2.</li>
<li data-sourcepos="382:3-382:151">Access expiration date for direct members of subgroups and projects <a data-sourcepos="382:73-382:135" href="https://gitlab.com/gitlab-org/gitlab/-/issues/471051" rel="nofollow noreferrer noopener" target="_blank">removed</a> in GitLab 17.4.</li>
</ul>
</blockquote>
<p data-sourcepos="384:1-384:54" dir="auto">You can give a user access to all projects in a group.</p>
<p data-sourcepos="386:1-386:14" dir="auto">Prerequisites:</p>
<ul data-sourcepos="388:1-391:0" dir="auto">
<li data-sourcepos="388:1-388:45">You must have the Owner role for the group.</li>
<li data-sourcepos="389:1-389:154">If <a data-sourcepos="389:6-389:102" href="../../administration/settings/sign_up_restrictions.md#disable-new-sign-ups">sign-up is disabled</a>, an administrator must add the user by email first.</li>
<li data-sourcepos="390:1-391:0">If <a data-sourcepos="390:6-390:146" href="../../administration/settings/sign_up_restrictions.md#turn-on-administrator-approval-for-role-promotions">administrator for role promotions</a> is turned on, an administrator must approve the invite.</li>
</ul>
<ol data-sourcepos="392:1-418:0" dir="auto">
<li data-sourcepos="392:1-392:71">
<p data-sourcepos="392:4-392:71">On the left sidebar, select <strong data-sourcepos="392:32-392:50">Search or go to</strong> and find your group.</p>
</li>
<li data-sourcepos="393:1-393:31">
<p data-sourcepos="393:4-393:31">Select <strong data-sourcepos="393:11-393:30">Manage > Members</strong>.</p>
</li>
<li data-sourcepos="394:1-394:29">
<p data-sourcepos="394:4-394:29">Select <strong data-sourcepos="394:11-394:28">Invite members</strong>.</p>
</li>
<li data-sourcepos="395:1-399:0">
<p data-sourcepos="395:4-395:15">If the user:</p>
<ul data-sourcepos="397:4-399:0">
<li data-sourcepos="397:4-397:53">Has a GitLab account, enter the user's username.</li>
<li data-sourcepos="398:4-399:0">Doesn't have a GitLab account, enter the user's email address.</li>
</ul>
</li>
<li data-sourcepos="400:1-400:83">
<p data-sourcepos="400:4-400:83">Select a <a data-sourcepos="400:13-400:45" href="../permissions.md">default role</a> or <a data-sourcepos="400:50-400:82" href="../custom_roles.md">custom role</a>.</p>
</li>
<li data-sourcepos="401:1-410:0">
<p data-sourcepos="401:4-402:68">Optional. For <strong data-sourcepos="401:18-401:43">Access expiration date</strong>, enter or select a date.
From that date onward, the user can no longer access the project.</p>
<p data-sourcepos="404:4-405:42">If you enter an access expiration date, the group member gets an email notification
seven days before their access expires.</p>
<p data-sourcepos="407:4-409:43">WARNING:
Maintainers have full permissions until their role expires, including the ability to
extend their own access expiration date.</p>
</li>
<li data-sourcepos="411:1-418:0">
<p data-sourcepos="411:4-412:35">Select <strong data-sourcepos="411:11-411:20">Invite</strong>.
If you invite the user by their:</p>
<ul data-sourcepos="414:4-418:0">
<li data-sourcepos="414:4-414:59">GitLab username, the user is added to the member list.</li>
<li data-sourcepos="415:4-418:0">Email address, the user receives an email invitation and is prompted to create an account.
If the invitation is not accepted, GitLab sends reminder emails two, five, and ten days later.
Unaccepted invites are automatically deleted after 90 days.</li>
</ul>
</li>
</ol>
<p data-sourcepos="419:1-420:28" dir="auto">Members that are not automatically added are displayed on the <strong data-sourcepos="419:63-419:73">Invited</strong> tab.
This tab includes users who:</p>
<ul data-sourcepos="422:1-425:0" dir="auto">
<li data-sourcepos="422:1-422:39">Have not yet accepted the invitation.</li>
<li data-sourcepos="423:1-423:91">Are waiting for <a data-sourcepos="423:19-423:90" href="../../administration/moderate_users.md">approval from an administrator</a>.</li>
<li data-sourcepos="424:1-425:0">
<a data-sourcepos="424:3-424:60" href="manage.md#user-cap-for-groups">Exceed the group user cap</a>.</li>
</ul>
<h3 data-sourcepos="426:1-426:32" dir="auto">
<a href="#view-users-pending-promotion" aria-hidden="true" class="anchor" id="user-content-view-users-pending-promotion"></a>View users pending promotion</h3>
<p data-sourcepos="428:1-428:268" dir="auto">If <a data-sourcepos="428:4-428:153" href="../../administration/settings/sign_up_restrictions.md#turn-on-administrator-approval-for-role-promotions">administrator approval for role promotions</a> is turned on, membership requests that promote existing users into a billable role require administrator approval.</p>
<p data-sourcepos="430:1-430:32" dir="auto">To view users pending promotion:</p>
<ol data-sourcepos="432:1-435:0" dir="auto">
<li data-sourcepos="432:1-432:71">On the left sidebar, select <strong data-sourcepos="432:32-432:50">Search or go to</strong> and find your group.</li>
<li data-sourcepos="433:1-433:31">Select <strong data-sourcepos="433:11-433:30">Manage > Members</strong>.</li>
<li data-sourcepos="434:1-435:0">Select the <strong data-sourcepos="434:15-434:33">Role promotions</strong> tab.</li>
</ol>
<p data-sourcepos="436:1-436:85" dir="auto">If the <strong data-sourcepos="436:8-436:26">Role promotions</strong> tab is not displayed, the group has no pending promotions.</p>
<h2 data-sourcepos="438:1-438:33" dir="auto">
<a href="#remove-a-member-from-the-group" aria-hidden="true" class="anchor" id="user-content-remove-a-member-from-the-group"></a>Remove a member from the group</h2>
<p data-sourcepos="440:1-440:14" dir="auto">Prerequisites:</p>
<ul data-sourcepos="442:1-446:0" dir="auto">
<li data-sourcepos="442:1-442:31">You must have the Owner role.</li>
<li data-sourcepos="443:1-446:0">The member must have direct membership in the group. If
membership is inherited from a parent group, then the member can be removed
from the parent group only.</li>
</ul>
<p data-sourcepos="447:1-447:32" dir="auto">To remove a member from a group:</p>
<ol data-sourcepos="449:1-457:0" dir="auto">
<li data-sourcepos="449:1-449:71">On the left sidebar, select <strong data-sourcepos="449:32-449:50">Search or go to</strong> and find your group.</li>
<li data-sourcepos="450:1-450:31">Select <strong data-sourcepos="450:11-450:30">Manage > Members</strong>.</li>
<li data-sourcepos="451:1-451:90">Next to the member you want to remove, select the vertical ellipsis (<strong data-sourcepos="451:73-451:88">{ellipsis_v}</strong>).</li>
<li data-sourcepos="452:1-452:28">Select <strong data-sourcepos="452:11-452:27">Remove member</strong>.</li>
<li data-sourcepos="453:1-455:70">Optional. On the <strong data-sourcepos="453:21-453:37">Remove member</strong> confirmation dialog, select one or both checkboxes:
<ul data-sourcepos="454:4-455:70">
<li data-sourcepos="454:4-454:71"><strong data-sourcepos="454:6-454:71">Also remove direct user membership from subgroups and projects</strong></li>
<li data-sourcepos="455:4-455:70"><strong data-sourcepos="455:6-455:70">Also unassign this user from linked issues and merge requests</strong></li>
</ul>
</li>
<li data-sourcepos="456:1-457:0">Select <strong data-sourcepos="456:11-456:27">Remove member</strong>.</li>
</ol>
<p data-sourcepos="458:1-458:164" dir="auto">GitLab administrators can also <a data-sourcepos="458:32-458:163" href="../project/members/index.md#ensure-removed-users-cannot-invite-themselves-back">ensure removed users cannot invite themselves back</a>.</p>
<h2 data-sourcepos="460:1-460:26" dir="auto">
<a href="#add-projects-to-a-group" aria-hidden="true" class="anchor" id="user-content-add-projects-to-a-group"></a>Add projects to a group</h2>
<p data-sourcepos="462:1-462:49" dir="auto">You can add a new project to a group in two ways:</p>
<ul data-sourcepos="464:1-468:0" dir="auto">
<li data-sourcepos="464:1-464:126">
<p data-sourcepos="464:3-464:126">Select a group, and then select <strong data-sourcepos="464:35-464:49">New project</strong>. You can then continue <a data-sourcepos="464:74-464:125" href="../../user/project/index.md">creating your project</a>.</p>
</li>
<li data-sourcepos="465:1-468:0">
<p data-sourcepos="465:3-465:74">While you are creating a project, select a group from the dropdown list.</p>
<p data-sourcepos="467:3-467:55"><a class="no-attachment-icon" href="img/select_group_dropdown_v13_10.png" target="_blank" rel="noopener noreferrer"><img data-sourcepos="467:3-467:55" src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" alt="Select group" decoding="async" class="lazy" data-src="img/select_group_dropdown_v13_10.png"></a></p>
</li>
</ul>
<h3 data-sourcepos="469:1-469:43" dir="auto">
<a href="#specify-who-can-add-projects-to-a-group" aria-hidden="true" class="anchor" id="user-content-specify-who-can-add-projects-to-a-group"></a>Specify who can add projects to a group</h3>
<p data-sourcepos="471:1-471:36" dir="auto">By default, users with at least the:</p>
<ul data-sourcepos="473:1-476:0" dir="auto">
<li data-sourcepos="473:1-473:80">Developer role can create projects under a group. This default can be changed.</li>
<li data-sourcepos="474:1-476:0">Maintainer role can fork projects into a group. This default prevents users with the Developer role from forking projects that
contain protected branches and cannot be changed.</li>
</ul>
<p data-sourcepos="477:1-477:58" dir="auto">To change the role that can create projects under a group:</p>
<ol data-sourcepos="479:1-484:0" dir="auto">
<li data-sourcepos="479:1-479:71">On the left sidebar, select <strong data-sourcepos="479:32-479:50">Search or go to</strong> and find your group.</li>
<li data-sourcepos="480:1-480:33">Select <strong data-sourcepos="480:11-480:32">Settings > General</strong>.</li>
<li data-sourcepos="481:1-481:57">Expand the <strong data-sourcepos="481:15-481:48">Permissions and group features</strong> section.</li>
<li data-sourcepos="482:1-482:63">From <strong data-sourcepos="482:9-482:44">Roles allowed to create projects</strong>, select an option.</li>
<li data-sourcepos="483:1-484:0">Select <strong data-sourcepos="483:11-483:26">Save changes</strong>.</li>
</ol>
<p data-sourcepos="485:1-485:179" dir="auto">To change this setting globally, see <a data-sourcepos="485:38-485:178" href="../../administration/settings/visibility_and_access_controls.md#define-which-roles-can-create-projects">Default project creation protection</a>.</p> </div> </main> </div> </div> </div> <script> //<![CDATA[ if ('loading' in HTMLImageElement.prototype) { document.querySelectorAll('img.lazy').forEach(img => { img.loading = 'lazy'; let imgUrl = img.dataset.src; // Only adding width + height for avatars for now if (imgUrl.indexOf('/avatar/') > -1 && imgUrl.indexOf('?') === -1) { const targetWidth = img.getAttribute('width') || img.width; imgUrl += `?width=${targetWidth}`; } img.src = imgUrl; img.removeAttribute('data-src'); img.classList.remove('lazy'); img.classList.add('js-lazy-loaded'); img.dataset.testid = 'js-lazy-loaded-content'; }); } //]]> </script> <script> //<![CDATA[ gl = window.gl || {}; gl.experiments = {}; //]]> </script> </body> </html>