Reserved project and group names
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
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 subgroups or projects.GROUP_ROUTES
are names reserved for all groups or projects.
Rules for usernames, project and group names, and slugs
- Usernames must start and end with a letter (
a-zA-Z
) or a digit (0-9
). Additionally:- Usernames and group names can contain only letters (
a-zA-Z
), digits (0-9
), emoji, underscores (_
), dots (.
), parentheses (()
), dashes (-
), or spaces. - Project names can contain only letters (
a-zA-Z
), digits (0-9
), emoji, underscores (_
), dots (.
), pluses (+
), dashes (-
), or spaces.
- Usernames and group names can contain only letters (
- Usernames and project or group slugs:
- Must start and end with a letter (
a-zA-Z
) or digit (0-9
). - Must not contain consecutive special characters.
- Cannot end in
.git
or.atom
. - Can contain only letters (
a-zA-Z
), digits (0-9
), underscores (_
), dots (.
), or dashes (-
).
- Must start and end with a letter (
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:
\-
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support