Reserved project and group names
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
- Project or group names must start with a letter, digit, emoji, or “_”.
- Project names can only contain letters, digits, emoji, “_”, “.”, “+”, dashes, or spaces.
- Group names can only contain letters, digits, emoji, “_”, “.”, parenthesis, dashes, or spaces.
- Project or group slugs must start with a letter or digit.
- Project or group slugs can only contain letters, digits, ‘_’, ‘.’, or dashes.
- Project or group slugs must not contain consecutive special characters.
- Project or group slugs cannot start or end with a special character.
- Project or group slugs cannot end in
.git
or.atom
.
Reserved project names
It is 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
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.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:
\-