# Risk Matrix

The Risk Matrix view plots your issues on a 3x3 grid based on their Risk and Impact values, providing a visual assessment of where project risks are concentrated.

## Prerequisites

The Risk Matrix requires two custom fields to be mapped in Hiera:

* **Risk** -- a field representing the likelihood or severity of risk (Low, Medium, High)
* **Impact** -- a field representing the business or project impact (Low, Medium, High)

Map these fields via the **Fields** button in the toolbar. See [Field Mapping](file:///1698742/admin-and-configuration/field-mapping.md) for details.

Only issues that have both Risk and Impact values set will appear on the matrix.

## The 3x3 Grid

The matrix is arranged with:

* **Risk** on the vertical axis (Low at the bottom, High at the top)
* **Impact** on the horizontal axis (Low on the left, High on the right)

Each cell of the grid contains markers representing the issues that fall into that risk/impact combination. The top-right cell (High Risk, High Impact) highlights the most critical items.

## KPI Cards

Summary cards at the top of the view display key risk metrics:

* Total number of issues with risk data
* Count of items in the High Risk / High Impact zone
* Distribution across risk levels

These cards update dynamically as you apply filters.

## Interaction

Click on any marker in the grid to open the issue detail panel. From there you can review the full issue, update fields, or navigate to the issue in Jira.

## Filters

The Risk Matrix respects all toolbar filters. Use the **Risk-only** toggle to restrict other views to show only items that have risk data, which helps maintain focus on risk-relevant items across your planning workflow.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hiera.gitbook.io/hiera-docs/views-and-features/risk-matrix.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.