doc/user/reserved_names.md
{{< details >}}
{{< /details >}}
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.Usernames must start and end with a letter (a-zA-Z) or a digit (0-9).
For example, the following usernames satisfy these criteria:
A_Garciaa_garcia_1Additionally, usernames and group names must contain only letters (a-zA-Z), digits (0-9), emoji, underscores (_), dots (.), parentheses (()), dashes (-), or spaces. For example:
sidney.jones or sidney ⭐ jonesWeb Development Team (Frontend)Project names must contain only letters (a-zA-Z), digits (0-9), emoji, underscores (_), dots (.), pluses (+), dashes (-), or spaces. For example:
web-app-v2+featuresweb-analytics-dashboardBackend API Service 🚀Usernames and project or group slugs:
a-zA-Z) or digit (0-9)..git or .atom.a-zA-Z), digits (0-9), underscores (_), dots (.), or dashes (-).Valid username slug examples:
dev_user_1zhang.wei-2024maria.lopezValid project slug examples:
api.service.v2user_management_portaldocs_site_v3Valid group slug examples:
marketing-team-2024backend.servicesmobile-dev-teamYou cannot create projects with the following names:
\-badgesblameblobbuildscommitscreatecreate_direditenvironments/foldersfilesfind_filegitlab-lfs/objectsinfo/lfs/objectsnewpreviewrawrefstreeupdatewikisYou cannot create groups with the following names, because they are reserved for top-level groups:
\-.well-known404.html422.html500.html502.html503.htmladminapiapple-touch-icon.pngassetsdashboarddeploy.htmlexplorefavicon.icofavicon.pngfilesgroupshealth_checkhelpimportjwtloginoauthprofileprojectspublicrobots.txtssearchsitemapsitemap.xmlsitemap.xml.gzslash-command-logo.pngsnippetsunsubscribesuploadsusersv2You cannot create subgroups with the following names:
\-