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

# Creating and managing recommendations

> How to add recommendations to a survey, and find, filter, and export them.

Recommendations are the actionable findings raised as part of a survey. Each recommendation captures what was found, the risk it presents, what action should be taken, and who is responsible.

Recommendations are created from the **Recommendations** tab on a survey record. They also roll up to the site record and client record so engineers and clients can track them across the portfolio.

To view, update, or respond to an existing recommendation, see [The recommendation record](https://docs.trurisk.io/the-recommendation-record.md).

## Adding a recommendation

From the survey's **Recommendations** tab, click **+ Add Recommendation**.

> [!NOTE]
>
> The fields available depend on the survey type. Recommendations on **property** surveys include the [Risk level](#risk-level) matrix and [Loss estimates](#loss-estimates). Recommendations on **energy** surveys don't include either of these sections.

### Recommendation details

| Field | Notes |
| - | - |
| Recommendation Name | A short title describing the finding |
| Recommendation ID | Auto-generated reference number (e.g. 2026.01) |
| Status | Current status of the recommendation. Defaults to **New** |
| Date Issued | Date the recommendation was raised. Defaults to the survey date |
| Survey Reference | Pre-filled with the current survey |
| Due Date | Target date for completion |

### Area details

| Field | Notes |
| - | - |
| Building / Structure | The specific building or structure where the finding was made |
| Area Coordinates | Location reference within the site |

### Risk classification

Select the **Risk Classification** category from the dropdown, and then the **Sub Classification** within it. This links the recommendation to the risk element it relates to (for example, *Protection → Manual fire fighting measures / hose reels + hydrants*).

On **energy** surveys, the classification is used to categorise the recommendation only — it isn't linked to the survey's risk classification elements. Some sub classifications have a further **Sub Element** field for more detail (for example, *Active Protection → Fixed Protection → Gas suppression*).

### Recommendation type

Select the type of improvement the recommendation calls for:

| Type | Use when |
| - | - |
| **CapEx** | Completing the recommendation requires capital expenditure — for example, building something or installing a physical protection system |
| **Human Element** | The recommendation is about processes or management practices — better risk management on site by staff |

### Risk level

*Property surveys only.* The **Risk Level** is determined using a **5×5 risk matrix**. Select the cell that best represents the combination of consequence and probability.

**Consequences (columns A–E):**

| Code | Level |
| - | - |
| A | Not Significant |
| B | Minor |
| C | Moderate |
| D | Major |
| E | Severe |

**Probability (rows 1–5):**

| Code | Level |
| - | - |
| 1 | Impractical |
| 2 | Not Likely |
| 3 | Possible |
| 4 | Likely |
| 5 | Certain |

The matrix is colour-coded green (low), amber (medium), and red (high). Selecting a cell auto-calculates the **Calculated Risk** score.

### Risk priority

| Field | Notes |
| - | - |
| Priority | The urgency of the recommendation: Critical (P1), Significant (P2), or Advisory (P3) |
| Client Classification | Internal classification label for the client-facing report |

| Priority | Meaning |
| - | - |
| **Critical (P1)** | The identified hazard has a critical exposure level to the facility with respect to property damage (PD), machinery breakdown (MB), business interruption (BI) or liability. The risk is considered as imminent and requires immediate rectification. |
| **Significant (P2)** | The identified hazard has a significant exposure level to the facility in terms of PD, MB, BI or liability. Implementation of such recommendations assists in the remediation of the risk control and loss prevention standards to that generally considered standard practice by the industry. Rectification should be planned within three months. |
| **Advisory (P3)** | The identified hazard has a modest exposure level to the facility in terms of PD, MB, BI or liability. These hazards do not directly pose a risk of severe loss or injury but could potentially contribute to loss events and reduction in risk quality. Rectification should be planned within six months. |

### Finding description

A rich-text field for describing what was observed during the survey. Supports formatting, images, and embedded content.

### Recommendation

A rich-text field for the recommended corrective action. This text appears in the issued report.

### Loss estimates

*Property surveys only.* An expandable section for estimating the financial impact of the recommendation:

| Field | Description |
| - | - |
| Cost to Complete | The estimated cost of implementing the recommendation |
| Before Completion | The estimated loss if the recommendation is **not** implemented |
| After Completion | The estimated loss once the recommendation has been implemented |

For each value, you can enter a single estimate, a range, or both.

### Recommendation contact

Assign a client contact to this recommendation. The contact is responsible for implementation and receives an email notification whenever an engineer posts a response on the recommendation. See [Responses](https://docs.trurisk.io/the-recommendation-record.md#responses).

## Recommendation statuses

Recommendations are tracked through to completion, with their status updated at each review. A recommendation can have one of the following statuses:

* New
* In Progress
* Under Review
* No Progress
* Pending Verification
* Completed
* Declined
* Superseded
* Withdrawn

New recommendations default to **New**.

## The recommendations list

Recommendations are listed in a filterable table — on the main **Recs** page, and on the **Recommendations** tab of client, site, and survey records.

| Column | Description |
| - | - |
| Reference | Auto-generated ID |
| Risk Level | The calculated risk score from the matrix |
| Recommendation | Short summary of the recommendation |
| Priority | Critical (P1), Significant (P2), or Advisory (P3) |
| Loss Est. | Estimated loss value |
| Status | Current recommendation status |

### Filtering recommendations

Every recommendations table in TruRisk — the main **Recs** page and the Recommendations tab on client, site, and survey records — has the same set of filters. Filters that don't apply in context are hidden (for example, the **Client** filter isn't shown on a client record).

| Filter | Description |
| - | - |
| Search | Find recommendations by keyword |
| Year | The year the recommendation was raised |
| Country | The country of the client or site |
| Risk Level | Pick a single cell on the risk matrix to show recommendations with that risk level (see below) |
| Survey Type | The type of survey the recommendation was raised in |
| Classification | The recommendation's risk classification, selected from the classification tree |
| Priority | Critical (P1), Significant (P2), or Advisory (P3) |
| Client | The client the recommendation belongs to |
| Status | The recommendation's current status |
| Overdue | Toggle on to show only overdue recommendations |

![The recommendations filter bar above the table](https://mintcdn.com/trurisk/5lhFCW44oYruSU9h/images/guide/recommendations-filters.png?fit=max\&auto=format\&n=5lhFCW44oYruSU9h\&q=85\&s=a2c79217d4c4d13beead13c23df968ec)

#### Filtering by risk level

The **Risk Level** filter opens the risk matrix. Each cell combines a consequence rating (columns) with a probability rating (rows). Click a single cell to filter by that risk level — the selected level is shown as the **Calculated Risk**. Click **Clear** to remove the filter.

![The Risk Level filter showing the 5×5 risk matrix](https://mintcdn.com/trurisk/5lhFCW44oYruSU9h/images/guide/risk-level-matrix.png?fit=max\&auto=format\&n=5lhFCW44oYruSU9h\&q=85\&s=bbcec5759314933b78e71aca679b942b)

| Consequences | Probability |
| - | - |
| A – Not Significant | 1 – Impractical |
| B – Minor | 2 – Not Likely |
| C – Moderate | 3 – Possible |
| D – Major | 4 – Likely |
| E – Severe | 5 – Certain |

#### Overdue recommendations

A recommendation is overdue when its due date has passed and it is still open. Declined, Withdrawn, and Superseded recommendations are never counted as overdue.

Overdue recommendations are highlighted in the table with a red **due \[time] ago** label under their status. Turn on the **Overdue** toggle to show only these recommendations.

The summary cards at the top of the tab show an aggregate breakdown of recommendations by **Status**, **Priority**, and **Estimated Loss Before Completion**.

> [!TIP]
>
> Loss estimate values are shown in your preferred currency. See [Currency preference](https://docs.trurisk.io/currency.md).

## Exporting recommendations

You can export recommendations in three ways:

| From | How |
| - | - |
| **A single recommendation** | Open the recommendation and click **Export**, then choose **Microsoft Word (.docx)** or **Comma-separated values (.csv)**. |
| **A recommendations table** | Tick the checkboxes next to the recommendations you want (or the checkbox in the header to select all), then click **Export** in the bar above the table. |
| **A site** | On the site record, open the **`···`** menu and select **Export Recommendations** to export all of that site's recommendations. |

> [!TIP]
>
> Apply filters before selecting recommendations in a table — for example, filter to **Overdue** or a single **Priority** — to export just the set you need.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.