---
layout: feature
title: Subgroups
suppress_header: true
extra_css:
  - gitlab-feature-landing-page.css
  - features.css
---
.wrapper.gitlab-ee-page
  = partial "includes/features/gitlab-ee-nav"
  .image-title
    .color-bg
      %div
        %h1 Subgroups
        %h3#description Manage large projects easily with Subgroups
        %a.btn.cta-btn.btn-white{ href: "https://docs.gitlab.com/ee/user/group/subgroups/index.html#subgroups" } Documentation
  .sub-wrapper
    .container
      .row#overview
        .col-xs-12.col-md-10.col-md-offset-1
          %h2 Overview
          %p.overview
            :markdown
              GitLab is a fully integrated software development application
              that enables you and your team to work cohesively, faster,
              transparently, and effectively, from the discussion of a
              new idea through deployment and monitoring.

              As a team-based collaboration platform, we're constantly
              enhancing GitLab's support for the most diverse teams and
              conditions. Looking on that direction, to leverage varied
              hierarchical team structures and applications architectures,
              we've created **GitLab Subgroups**.

              With [GitLab Groups](https://docs.gitlab.com/ee/user/group/)
              you can assemble related projects together and grant members
              access to several projects at once. A [subgroup](https://docs.gitlab.com/ee/user/group/subgroups/), also known as _nested group_ or _hierarchical group_,
              is essentially a group within a group. It has the same features
              a top-level group has, with some
              [limitations](https://docs.gitlab.com/ee/user/group/subgroups/#limitations).

              Each group, at each level, is itself a first-class GitLab citizen,
              with the ability to have multiple projects. You can create up to 20
              levels of subgroups, giving you an incredible level of flexibility.

      %hr.divider/

      .row#benefit-1
        .col-md-4.hidden-xs.hidden-sm
          .ee-feature-icon
            = icon("checklist-icon")
        .col-xs-12.col-md-6.col-md-offset-1
          %h2 How it works
          .overview
            :markdown
              - [Create a new group](https://docs.gitlab.com/ee/user/group/#create-a-new-group)
                in GitLab, from which you can create subgroups.
              - [Create a subgroup](https://docs.gitlab.com/ee/user/group/subgroups/#creating-a-subgroup) for one of your teams.
              - Add new [projects](https://docs.gitlab.com/ee/user/project/#projects) into your
                subgroup.
              - You can now add [members](https://docs.gitlab.com/ee/user/group/subgroups/#membership)
                to your subgroup, who will automatically inherit their permission level to all
                the projects within their subgroup.
              - [Mention](https://docs.gitlab.com/ee/user/group/subgroups/#mentioning-subgroups)
                your subgroup in any [discussion](https://docs.gitlab.com/ee/user/discussions/)
                (in issues, MRs, commits, snippets) and all its members will get a notification.

      %hr.divider/

      .row#benefit-2
        .col-xs-12.col-md-6.col-md-offset-1
          %h2 Benefits
          .overview
            :markdown
              - **Easily configurable:** Once you create a subgroup, the
                only thing you need to set is the [visibility level](https://docs.gitlab.com/ee/public_access/public_access.html) (public, internal, or private).
              - **Maintain your workflow leveraged by GitLab:** effectively organize your
                projects or teams within groups and subgroups so that you can easily add
                new members, change their access level, and create projects respecting
                your company's structure.

        .col-md-4.col-md-offset-1.hidden-xs.hidden-sm
          .ee-feature-icon
            = icon("file-locking-icon-2")
      %hr.divider/