Basic Info

Groups are created to simplify navigation and facilitate usage of the repositories. Using Groups you can assemble related projects together and grant members access to several projects at once. Find your groups on the top-left side of the navigation bar by clicking the Groups button.

The Groups page displays all groups you are a member of, your permissions, how many projects it holds, how many members it has, the group visibility, and (if you have enough permissions) a link to the group settings. By clicking the last button you can leave that group 😊.

Creating New Group

If you have enough permissions you can create a group in GitLab from the Groups page by clicking the green New group button:

...or, expand the "+" plus sign button on the top navigation bar and choose New group:

On the New Group page add the following information:

• The Group path which will be the namespace under which your projects will be hosted (path can contain only letters, digits, underscores, dashes and dots, it cannot start with dashes or end in dot).

• The Group name will populate with the path. Optionally, you can change it. This is the name that will display in the group views.

• Optionally, you can add a description so that others can briefly understand what this group is about.

• Optionally, choose an avatar for your project.

• Choose the visibility levelopen in new window.

After the new group has been created, you can add members to a group by navigating to the group's dashboard, and clicking Members. You can select the permission levelopen in new window, set the expiring date for that user, from which they will no longer have access to your group and add the new member.

One of the profit of putting multiple projects in one group is that you can give a user to access to all projects in the group with one action. You can increase the access level of an individual user for a specific project, by adding them again as a new member to the project with the new permission levels.

Requesting Access to a Group

As a user, you can request to be a member of a group. Go to the group you would like to be a member of, and click the Request Access button on the right side of your screen.