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.
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
abuse_reports
admin
api
apple-touch-icon-precomposed.png
apple-touch-icon.png
assets
autocomplete
dashboard
deploy.html
explore
favicon.ico
favicon.png
files
groups
health_check
help
import
invites
jwt
login
oauth
profile
projects
public
robots.txt
s
search
sent_notifications
slash-command-logo.png
snippets
unsubscribes
uploads
users
v2
These group names are unavailable as subgroup names:
\-
Help and feedback
If there's something you don't like about this feature
To propose functionality that GitLab does not yet offer
To further help GitLab in shaping new features
If you didn't find what you were looking for
If you want help with something very specific to your use case, and can use some community support
POST ON GITLAB FORUM
If you have problems setting up or using this feature (depending on your GitLab subscription)
REQUEST SUPPORT
To view all GitLab tiers and features or to upgrade
If you want to try all features available in GitLab.com
If you want to try all features available in GitLab self-managed
If you spot an error or a need for improvement and would like to fix it yourself in a merge request
EDIT THIS PAGE
If you would like to suggest an improvement to this doc