• Types of namespaces
• Determine which type of namespace you’re in
• Name limitations

Namespaces

Namespaces organize projects in GitLab. Because each namespace is separate, you can use the same project name in multiple namespaces.

Types of namespaces

GitLab has two types of namespaces:

• User: Your personal namespace is based on your username. In a personal namespace:
  • You cannot create subgroups.
  • Groups do not inherit your namespace permissions or group features.
  • All the projects you create are under the scope of this namespace.
  • Changes to your username also change project and namespace URLs. Before you change your username, read about repository redirects.
• Group: A group or subgroup namespace is based on the group or subgroup name. In group and subgroup namespaces:
  • You can create multiple subgroups to manage multiple projects.
  • Subgroups inherit some of the parent group settings. You can view these in the subgroup Settings.
  • You can configure settings specifically for each subgroup and project.
  • You can manage the group or subgroup URL independently of the name.

Determine which type of namespace you’re in

To determine whether you’re in a group or personal namespace, you can view the URL. For example:

Name limitations

When you choose a name for your namespace, keep in mind the character limitations and reserved group names.