Reserved project and group names (FREE)

Not all project & group names are allowed because they would conflict with existing routes used by GitLab.

For a list of words that are not allowed to be used as group or project names, see the path_regex.rb file under the TOP_LEVEL_ROUTES, PROJECT_WILDCARD_ROUTES and GROUP_ROUTES lists:

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

Limitations on project and group names

• Special characters are not permitted at the start or end of project or group names. They are permitted in any other location of the name.
• Project or group names cannot end in .git or .atom.
• Project or group names can only contain letters, digits, emojis, "_", ".", "+", dashes, or spaces.
• Paths can only contain letters, digits, "_", "-", and "."

Reserved project names

It is currently not possible to create a project 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

Currently, the following names are reserved as top level groups:

• \-
• .well-known
• 404.html
• 422.html
• 500.html
• 502.html
• 503.html
• admin
• api
• apple-touch-icon-precomposed.png
• 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

These group names are unavailable as subgroup names:

• \-