> ## Documentation Index
> Fetch the complete documentation index at: https://docs-bo.clear-gate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Findings

> Manage the library of security findings used across penetration testing reports.

<Note>
  **Role access:** Admin and Editor roles can manage findings. Users do not have access to this section.
</Note>

## Overview

The Findings section manages the reusable library of security findings. These templates are used when creating report-specific findings during penetration tests.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/cleargate/images/screenshots/backoffice/findings-list.png" alt="Findings list" style={{ borderRadius: '8px', border: '1px solid #e5e7eb' }} />

## Findings List

### Table Columns

| Column                | Description                      |
| --------------------- | -------------------------------- |
| **Finding Name**      | The name/title of the finding    |
| **Recommendations #** | Number of linked recommendations |

### Actions

| Action                   | Icon        | Description                                        |
| ------------------------ | ----------- | -------------------------------------------------- |
| **Add Finding**          | Button      | Create a new finding                               |
| **View**                 | Eye icon    | View finding details (read-only)                   |
| **Edit**                 | Pencil icon | Edit the finding                                   |
| **View Recommendations** | Link icon   | View recommendations linked to this finding        |
| **Delete**               | Trash icon  | Delete the finding (Admin only, with confirmation) |

### Filtering & Pagination

* **Search** — filter findings by name
* **Pagination** — select 10, 25, 50, 100, or 1000 entries per page
* **Refresh** — reload the findings list

## Creating a Finding

<Steps>
  <Step title="Click Add Finding">
    Click the **Add Finding** button at the top of the findings list.
  </Step>

  <Step title="Fill in finding details">
    Complete the finding fields including name, severity, description, and CVSS score.
  </Step>

  <Step title="Link recommendations">
    Optionally link one or more recommendations to the finding.
  </Step>

  <Step title="Save">
    Click **Save** to create the finding.
  </Step>
</Steps>

<img src="https://mintlify.s3.us-west-1.amazonaws.com/cleargate/images/screenshots/backoffice/findings-create.png" alt="Create finding form" style={{ borderRadius: '8px', border: '1px solid #e5e7eb' }} />

## Finding Details

Each finding contains:

* **Name** — the title of the finding
* **Severity** — Critical, High, Medium, or Low
* **CVSS Score** — numeric CVSS rating
* **Description** — detailed explanation of the vulnerability
* **Linked Recommendations** — recommendations associated with this finding

<img src="https://mintlify.s3.us-west-1.amazonaws.com/cleargate/images/screenshots/backoffice/findings-view.png" alt="Finding detail view" style={{ borderRadius: '8px', border: '1px solid #e5e7eb' }} />

## Finding Severity Levels

| Severity     | Color  | Description                                          |
| ------------ | ------ | ---------------------------------------------------- |
| **Critical** | Red    | Immediate risk requiring urgent action               |
| **High**     | Orange | Significant risk that should be addressed quickly    |
| **Medium**   | Yellow | Moderate risk that should be planned for remediation |
| **Low**      | Green  | Minor risk with limited impact                       |

## Managing Linked Recommendations

From a finding's detail page, you can navigate to its linked recommendations. This shows all recommendations that apply to the finding and allows you to add or remove links.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/cleargate/images/screenshots/backoffice/findings-recommendations-link.png" alt="Finding linked recommendations" style={{ borderRadius: '8px', border: '1px solid #e5e7eb' }} />