Organization

Organization will be above the top-level namespaces for you to manage everything you do as a GitLab administrator, including:

• Defining and applying settings to all of your groups, subgroups, and projects.
• Aggregating data from all your groups, subgroups, and projects.

For more information about the state of organization development, see epic 9265.

View organizations

To view the organizations you have access to:

• On the left sidebar, select Organizations.

Create an organization

1. On the left sidebar, at the top, select Create new ( ) and New organization.
2. In the Organization name text box, enter a name for the organization.
3. In the Organization URL text box, enter a path for the organization.
4. In the Organization description text box, enter a description for the organization. Supports a limited subset of Markdown.
5. In the Organization avatar field, select Upload or drag and drop an avatar.
6. Select Create organization.

Edit an organization’s name

1. On the left sidebar, select Organizations and find the organization you want to edit.
2. Select Settings > General.
3. In the Organization name text box, edit the name.
4. In the Organization description text box, edit the description. Supports a limited subset of Markdown.
5. In the Organization avatar field, if an avatar is:
   • Selected, select Remove avatar to remove.
   • Not selected, select Upload or drag and drop an avatar.
6. Select Save changes.

Change an organization’s URL

1. On the left sidebar, select Organizations and find the organization whose URL you want to change.
2. Select Settings > General.
3. Expand the Advanced section.
4. In the Organization URL text box, edit the URL.
5. Select Change organization URL.

View an organization’s visibility level

1. On the left sidebar, select Organizations and find your organization.
2. Select Settings > General.
3. Expand the Visibility section.

Switch organizations

To switch organizations:

• On the left sidebar, in the upper corner, from the Current organization dropdown list select the organization you want to switch to.

Manage groups and projects

1. On the left sidebar, select Organizations and find the organization you want to manage.
2. Select Manage > Groups and projects.
3. Optional. Filter the results:
   • To search for specific groups or projects, in the search box enter your search term (minimum three characters).
   • To view only groups or projects, from the Display dropdown list select an option.
4. Optional. To sort the results by name, date created, or date updated, from the dropdown list select an option. Then select ascending ( ) or descending ( ) order.

Create a group in an organization

1. On the left sidebar, select Organizations and find the organization you want to create a group in.
2. Select Manage > Groups and projects.
3. Select New group.
4. In the Group name text box, enter the name of the group. For a list of words that cannot be used as group names, see reserved names.
5. In the Group URL text box, enter the path for the group used for the namespace.
6. Select the Visibility level of the group.
7. Select Create group.

View users

1. On the left sidebar, select Organizations and find the organization you want to view.
2. Select Manage > Users.

Change a user’s role

Prerequisites:

• You must have the Owner role for the organization.

To change a user’s role:

1. On the left sidebar, select Organizations and find the organization you want to manage.
2. Select Manage > Users.
3. Find the user whose role you want to update.
4. From the Organization role dropdown list, select a role.

Supported Markdown for Organization description

The Organization description field supports a limited subset of GitLab Flavored Markdown, including:

• Emphasis
• Links
• Superscripts / Subscripts

Related topics

• Organization developer documentation
• Organization design document