Project features and permissions
DETAILS: Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
Configure project features and permissions
To configure features and permissions for a project:
- On the left sidebar, select Search or go to and find your project.
- Select Settings > General.
- Expand Visibility, project features, permissions.
- To allow users to request access to the project, select the Users can request access checkbox.
- To enable or disable features in the project, use the feature toggles.
- Select Save changes.
When you disable a feature, the following additional features are also disabled:
-
If you disable the Issues feature, project users cannot use:
- Issue Boards
- Service Desk
- Project users can still access Milestones from merge requests.
-
If you disable Issues and Merge Requests, project users cannot use:
- Labels
- Milestones
-
If you disable Repository, project users cannot access:
- Merge requests
- CI/CD
- Git Large File Storage
- Packages
-
The metrics dashboard requires read access to project environments and deployments. Users with access to the metrics dashboard can also access environments and deployments.
Enable and disable project features
Enabled project features are visible and accessible to project members. You can disable specific project features, so that they are not visible and accessible to project members, regardless of their role.
To enable or disable individual features in a project:
- On the left sidebar, select Search or go to and find your project.
- Select Settings > General.
- Expand Visibility, project features, permissions.
- To enable a feature, turn on the toggle. To disable a feature, turn off the toggle.
- Select Save changes.
Disable project analytics
By default, project analytics are displayed under the Analyze item in the left sidebar. To disable this feature and remove the Analyze item from the left sidebar:
- On the left sidebar, select Search or go to and find your project.
- Select Settings > General.
- Expand Visibility, project features, permissions.
- Turn off the Analytics toggle.
- Select Save changes.
Disable CVE identifier request in issues
DETAILS: Tier: Free, Premium, Ultimate Offering: GitLab.com
- Introduced in GitLab 13.4, only for public projects on GitLab.com.
In some environments, users can submit a CVE identifier request in an issue.
To disable the CVE identifier request option in issues in your project:
- On the left sidebar, select Search or go to and find your project.
- Select Settings > General.
- Expand Visibility, project features, permissions.
- Under Issues, turn off the CVE ID requests in the issue sidebar toggle.
- Select Save changes.
Disable project email notifications
Prerequisites:
- You must have the Owner role for the project.
- On the left sidebar, select Search or go to and find your project.
- Select Settings > General.
- Expand Visibility, project features, permissions.
- Clear the Disable email notifications checkbox.
Configure merge request settings for a project
Configure your project's merge request settings:
- Set up the merge request method (merge commit, fast-forward merge).
- Add merge request description templates.
- Enable:
- Configure:
- Suggested changes commit messages.
- Merge and squash commit message templates.
- Default target project for merge requests coming from forks.
Delete the source branch on merge by default
In merge requests, you can change the default behavior so that the Delete the source branch checkbox is always selected.
To set this default:
- On the left sidebar, select Search or go to and find your project.
- Select Settings > Merge requests.
- Select Enable "Delete source branch" option by default.
- Select Save changes.