Vulnerability Report
DETAILS: Tier: Ultimate Offering: SaaS, Self-managed
The Vulnerability Report provides information about vulnerabilities from scans of the default branch. It contains cumulative results of all successful jobs, regardless of whether the pipeline was successful. The scan results from a pipeline are only ingested after all the jobs in the pipeline complete.
For an overview, see Vulnerability Management.
At all levels, the Vulnerability Report contains:
- Totals of vulnerabilities per severity level.
- Filters for common vulnerability attributes.
- Details of each vulnerability, presented in tabular layout.
At the project level, the Vulnerability Report also contains:
- A time stamp showing when it was updated, including a link to the latest pipeline.
- The number of failures that occurred in the most recent pipeline. Select the failure notification to view the Failed jobs tab of the pipeline's page.
The Activity column contains icons to indicate the activity, if any, taken on the vulnerability in that row:
- Issues {issues}: Links to issues created for the vulnerability. For more information, see Create a GitLab issue for a vulnerability.
- Wrench {admin}: The vulnerability has been remediated.
- False positive {false-positive}: The scanner determined this vulnerability to be a false positive.
To open an issue created for a vulnerability, hover over the Activity entry, then select the link. The issue icon ({issues}) indicates the issue's status. If Jira issue support is enabled, the issue link found in the Activity entry links out to the issue in Jira. Unlike GitLab issues, the status of a Jira issue is not shown in the GitLab UI.
When vulnerabilities originate from a multi-project pipeline setup, this page displays the vulnerabilities that originate from the selected project.
View the vulnerability report
View the vulnerability report to list all vulnerabilities in the project or group.
Prerequisites:
- You must have at least the Developer role for the project or group.
To view the vulnerability report:
- On the left sidebar, select Search or go to and find your project or group.
- Select Secure > Vulnerability report.
Vulnerability Report filters
You can filter the Vulnerability Report to narrow focus on only vulnerabilities matching specific criteria.
The filters available at all levels are:
- Status: Detected, confirmed, dismissed, resolved. For details on what each status means, see vulnerability status values.
- Severity: Critical, high, medium, low, info, unknown.
- Tool: For more details, see Tool filter.
- Activity: For more details, see Activity filter.
Additionally, the project filter is available at the group level.
Filter the list of vulnerabilities
To filter the list of vulnerabilities:
- On the left sidebar, select Search or go to and find your project.
- Select Secure > Vulnerability report.
- Select a filter.
- Select values from the dropdown list.
- Repeat the above steps for each desired filter.
After each filter is selected:
- The list of matching vulnerabilities is updated.
- The vulnerability severity totals are updated.
Tool filter
- Project-level tool filter introduced in GitLab 16.6.
You can filter vulnerabilities by the tool that detected them. By default, the vulnerability report lists vulnerabilities from all tools. When you select a heading, you select all the tools under that heading.
::Tabs
:::TabTitle GitLab 16.6 and later
The content of the tool filter for both projects and groups depends on the following:
- If you've integrated and enabled third-party analyzers, the tool filter is grouped by scanning category (for example, container scanning, DAST, and dependency scanning). Scanner entries are only shown if the scanner detected vulnerabilities.
- If you have not integrated any third-party analyzers, see GitLab 16.5 and earlier.
:::TabTitle GitLab 16.5 and earlier
The content of the tool filter at all levels is categorized first by the analyzer's vendor, then by scanning category. If you've only enabled GitLab analyzers, only those analyzers are listed in the tool filter.
::EndTabs
To filter vulnerabilities that were added manually, use the Manually added filter.
For details of each of the available tools, see Security scanning tools.
Project filter
The content of the Project filter depends on the current level:
- Security Center: Only projects you've added to your personal Security Center.
- Group level: All projects in the group.
- Project level: Not applicable.
Activity filter
- Introduced in GitLab 16.7 with a flag named
activity_filter_has_remediations
. Disabled by default.- Generally available in GitLab 16.9. Feature flag
activity_filter_has_remediations
removed.
The activity filter behaves differently from the other filters. You can select only one value in each category. To remove a filter, from the activity filter dropdown list select the filter you want to remove.
Selection behavior when using the activity filter:
-
Activity
- All activity: Vulnerabilities with any activity status (same as ignoring this filter). Selecting this deselects all other activity filter options.
-
Detection
-
Still detected (default): Vulnerabilities that are still detected in the latest pipeline scan of the
default
branch. -
No longer detected: Vulnerabilities that are no longer detected in the latest pipeline scan of the
default
branch.
-
Still detected (default): Vulnerabilities that are still detected in the latest pipeline scan of the
-
Issue
- Has issues: Vulnerabilities with one or more associated issues.
- Does not have issue: Vulnerabilities without an associated issue.
-
Merge request
- Has merge request: Vulnerabilities with one or more associated merge requests.
- Does not have merge request: Vulnerabilities without an associated merge request.
-
Solution available
- Has a solution: Vulnerabilities with an available solution.
- Does not have a solution: Vulnerabilities without an available solution.
View details of a vulnerability
To view more details of a vulnerability, select the vulnerability's Description. The vulnerability's details page is opened.
View vulnerable source location
Some security scanners output the filename and line number of a potential vulnerability. When that information is available, the vulnerability's details include a link to the relevant file, in the default branch.
To view the relevant file, select the filename in the vulnerability's details.
Change status of vulnerabilities
- Providing a comment and dismissal reason introduced in GitLab 16.0.
As you triage vulnerabilities you can change their status, including dismissing vulnerabilities.
When a vulnerability is dismissed, the audit log includes a note of who dismissed it, when it was dismissed, and the reason it was dismissed. You cannot delete vulnerability records, so a permanent record always remains.
To change the status of vulnerabilities:
- On the left sidebar, select Search or go to and find your project.
- Select Secure > Vulnerability report.
- To select:
- One or more vulnerabilities, select the checkbox beside each vulnerability.
- All vulnerabilities on the page, select the checkbox in the table header.
- In the Set status dropdown list, select the desired status.
- If the Dismiss status is chosen, select the desired reason in the Set dismissal reason dropdown list.
- In the Add a comment input, you can provide a comment. For the Dismiss status, a comment is required.
- Select Change status.
The status of the selected vulnerabilities is updated and the content of the vulnerability report is refreshed.
Sort vulnerabilities by date detected
By default, vulnerabilities are sorted by severity level, with the highest-severity vulnerabilities listed at the top.
To sort vulnerabilities by the date each vulnerability was detected, select the "Detected" column header.
Export vulnerability details
- Added "Dismissal Reason" as a column in the CSV export introduced in GitLab 16.8.
You can export details of the vulnerabilities listed in the Vulnerability Report. The export format is CSV (comma separated values). All vulnerabilities are included because filters do not apply to the export.
Fields included are:
- Status (See the following table for details of how the status value is exported.)
- Group name
- Project name
- Tool
- Scanner name
- Vulnerability
- Basic details
- Additional information
- Severity
- CVE (Common Vulnerabilities and Exposures)
- CWE (Common Weakness Enumeration)
- Other identifiers
- Detected At
- Location
- Activity: Returns
true
if the vulnerability is resolved on the default branch, andfalse
if not. - Comments
- Full Path
- CVSS Vectors
- Dismissal Reason
NOTE:
Full details are available through our
Job Artifacts API.
Use one of the gl-*-report.json
report filenames in place of *artifact_path
to obtain, for example, the path of files in which vulnerabilities were detected.
The Status field's values shown in the vulnerability report are different to those contained in the vulnerability export. Use the following reference table to match them.
Vulnerability report | Vulnerability export |
---|---|
Needs triage | detected |
Dismissed | dismissed |
Resolved | resolved |
Confirmed | confirmed |
Export details in CSV format
To export details of all vulnerabilities listed in the Vulnerability Report, select Export.
The details are retrieved from the database, then the CSV file is downloaded to your local computer.
NOTE: It may take several minutes for the download to start if your project contains thousands of vulnerabilities. Do not close the page until the download finishes.
Manually add a vulnerability
- Introduced in GitLab 14.9. Disabled by default.
- Enabled on GitLab.com in GitLab 14.10.
- Feature flag
new_vulnerability_form
removed in GitLab 15.0.
Add a vulnerability manually when it is not available in the GitLab vulnerabilities database. You can add a vulnerability only in a project's vulnerability report.
To add a vulnerability manually:
- On the left sidebar, select Search or go to and find your project.
- Select Secure > Vulnerability report.
- Select Submit vulnerability.
- Complete the fields and submit the form.
The newly-created vulnerability's detail page is opened.
Group vulnerabilities
- Introduced in GitLab 16.4 with a flag named
vulnerability_report_grouping
. Disabled by default.- Generally available in GitLab 16.6. Feature flag
vulnerability_report_grouping
removed.
In the project-level vulnerability report you can group vulnerabilities, enabling more efficient triaging.
To group vulnerabilities in the vulnerability report:
- On the left sidebar, select Search or go to and find your project.
- Select Secure > Vulnerability report.
- From the Group By dropdown list, select an attribute.
Vulnerabilities are grouped according to the attribute you selected. Each group is collapsed, with totals per group displayed beside their name. To see the vulnerabilities in each group, select the group's name.
Operational vulnerabilities
- Introduced in GitLab 14.6.
The Operational vulnerabilities tab lists vulnerabilities found by Operational container scanning. This tab appears on the project, group, and Security Center vulnerability reports.