Organizations

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab Self-Managed
  • Status: Experiment

Version history

[!flag] The availability of this feature is controlled by a feature flag. For more information, see the history. This feature is available for testing, but still in development and not ready for production use.

Organizations 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.

[!disclaimer]

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

Create an organization

Version history

  • Introduced in GitLab 16.11 with a flag named allow_organization_creation. Disabled by default.
  • Feature flag changed to organization_switching in GitLab 18.4. Disabled by default. Feature flag allow_organization_creation removed.
  1. In the upper-right corner, 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.

Switch organizations

Version history

If you are a member of multiple organizations, you can switch between them. To switch organizations:

  1. In the left sidebar, at the top, select the Current organization dropdown list.
  2. Select the organization you want to switch to.

Supported Markdown for Organization description

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