Groups (FREE)

In GitLab, you use groups to manage one or more related projects at the same time.

You can use groups to manage permissions for your projects. If someone has access to the group, they get access to all the projects in the group.

You can also view all of the issues and merge requests for the projects in the group, and view analytics that show the group's activity.

You can use groups to communicate with all of the members of the group at once.

For larger organizations, you can also create subgroups.

For more information about creating and managing your groups, see Manage groups.

NOTE: Self-managed customers should create a top-level group so you can see an overview of your organization. For more information about efforts to create an organization view of all groups, see epic 9266. A top-level group can also have one complete Security Dashboard and Center, Vulnerability and Compliance Report, and Value stream analytics.

Group visibility

Like projects, a group can be configured to limit the visibility of it to:

• Anonymous users.
• All authenticated users.
• Only explicit group members.

The restriction for visibility levels 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.

Administrator users cannot create a subgroup or project with a higher visibility level than that of the immediate parent group.

Related topics

• Group wikis
• Maximum artifacts size.
• Repositories analytics: View overall activity of all projects with code coverage.
• Contribution analytics: View the contributions (pushes, merge requests, and issues) of group members.
• Issue analytics: View a bar chart of your group's number of issues per month.
• Use GitLab as a dependency proxy for upstream Docker images.
• Epics: Track groups of issues that share a theme.
• Security Dashboard: View the vulnerabilities of all the projects in a group and its subgroups.
• Insights: Configure insights like triage hygiene, issues created/closed per a given period, and average time for merge requests to be merged.
• Webhooks.
• Kubernetes cluster integration.
• Audit Events.
• CI/CD minutes quota: Keep track of the CI/CD minute quota for the group.
• Integrations.
• Transfer a project into a group.
• Share a project with a group: Give all group members access to the project at once.
• Lock the sharing with group feature.
• Enforce two-factor authentication (2FA): Enforce 2FA for all group members.
• Namespaces API and Rake tasks.
• Control access and visibility.