Skip to content

Organization

FLAG: This feature is not ready for production use. On self-managed GitLab, by default this feature is not available. To make it available, an administrator can enable the feature flag named ui_for_organizations. On GitLab.com, this feature is not available.

DISCLAIMER: This page contains information related to upcoming products, features, and functionality. It is important to note that the information presented is for informational purposes only. Please do not rely on this information for purchasing or planning purposes. As with all projects, the items mentioned on this page are subject to change or delay. The development, release, and timing of any products, features, or functionality remain at the sole discretion of GitLab Inc.

NOTE: Organization is in development.

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 ({organization}).

Create an organization

  1. On the left sidebar, at the top, select Create new ({plus}) 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 ({organization}) 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 ({organization}) and find 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.

Manage groups and projects

  1. On the left sidebar, select Organizations ({organization}) 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.
    • 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 ({sort-lowest}) or descending ({sort-highest}) order.

Manage users

  1. On the left sidebar, select Organizations ({organization}) and find the organization you want to manage.
  2. Select Manage > Users.

Supported Markdown for Organization description

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

Related topics