Reserved project and group names

To not conflict with existing routes used by GitLab, some words cannot be used as project or group names. These words are listed in the path_regex.rb file, where:

  • TOP_LEVEL_ROUTES are names reserved as usernames or top-level groups.
  • PROJECT_WILDCARD_ROUTES are names reserved for child groups or projects.
  • GROUP_ROUTES are names reserved for all groups or projects.

Limitations on project and group names

  • Project or group names must start with a letter (a-zA-Z), digit (0-9), emoji, or underscore (_). Additionally:
    • Project names can contain only letters (a-zA-Z), digits (0-9), emoji, underscores (_), dots (.), pluses (+), dashes (-), or spaces.
    • Group names can contain only letters (a-zA-Z), digits (0-9), emoji, underscores (_), dots (.), parentheses (()), dashes (-), or spaces.
  • Project or group slugs:
    • Must start with a letter (a-zA-Z) or digit (0-9).
    • Must not contain consecutive special characters.
    • Cannot start or end with a special character.
    • Cannot end in .git or .atom.
    • Can contain only letters (a-zA-Z), digits (0-9), underscores (_), dots (.), or dashes (-).

Reserved project names

You cannot create projects with the following names:

  • \-
  • badges
  • blame
  • blob
  • builds
  • commits
  • create
  • create_dir
  • edit
  • environments/folders
  • files
  • find_file
  • gitlab-lfs/objects
  • info/lfs/objects
  • new
  • preview
  • raw
  • refs
  • tree
  • update
  • wikis

Reserved group names

You cannot create groups with the following names, because they are reserved for top-level groups:

  • \-
  • .well-known
  • 404.html
  • 422.html
  • 500.html
  • 502.html
  • 503.html
  • admin
  • api
  • apple-touch-icon.png
  • assets
  • dashboard
  • deploy.html
  • explore
  • favicon.ico
  • favicon.png
  • files
  • groups
  • health_check
  • help
  • import
  • jwt
  • login
  • oauth
  • profile
  • projects
  • public
  • robots.txt
  • s
  • search
  • sitemap
  • sitemap.xml
  • sitemap.xml.gz
  • slash-command-logo.png
  • snippets
  • unsubscribes
  • uploads
  • users
  • v2

You cannot create subgroups with the following names:

  • \-