Gitlab hero border pattern left svg Gitlab hero border pattern right svg

Category Direction - Subgroups

Stage Group Maturity Content Last Reviewed
Manage Access Complete 2021-07-25

Introduction and how you can help

Thanks for visiting this category page on Subgroups in GitLab. This vision and direction is a work in progress and sharing your feedback directly on issues and epics on is the best way to contribute.


Groups are a fundamental building block (a small primitive) in GitLab that serve to:

Our mission

In 2021, our goal is to make improvements by extending Subgroups to help enterprise organizations thrive on We will accomplish that by iterating on existing constructs and streamlining workflows to guide users to intended usage patterns.


Historically, enterprise customers have gravitated toward self-managed GitLab as their favored solution. With the proliferation of cloud services, enterprises are looking for options to use GitLab with managed infrastructure. We need to provide a SaaS platform that can safely and securely house our customers while reducing the load and cost of having to manage and configure their own infrastructure.


Iterating on subgroups will allow us to solve a number of problems with the current SaaS experience:

Target audience and experience

Groups are used by all GitLab users, no matter what role. However, heavier users of Groups in terms of organization and management of projects and users consist of:

What's Next and Why

The Access group will be investing most capacity in performance and security for the Auth category in the short-term.

We plan to invest in building the workspace concept in the next few milestones. This will be the top-level namespace for you to manage everything GitLab. We will start by introducing issues into this top level group via gitlab&4257.

We will also continue to make targeted investments in the short-term to advance our SaaS experience:

What is Not Planned Right Now


This category is currently Complete. The next step in our maturity plan is achieving a Lovable state.

Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license