# SmartVisuals Risk Matrix for Power BI

> Risk matrix and risk heat map for Power BI: 3x3 to 10x10, your thresholds or an asymmetric band table, every risk by name. Free; Premium adds the committee review.

- Page: https://www.smartvisuals.io/visuals/risk-matrix
- Fields and settings: https://www.smartvisuals.io/visuals/risk-matrix/settings
- Microsoft Marketplace: https://marketplace.microsoft.com/en-us/product/smartvisuals.smartvisuals-risk-matrix?tab=overview
- Package: https://www.smartvisuals.io/downloads/smartvisuals-risk-matrix-1.0.0.0.pbiviz
- Price: Free tier for every viewer; premium $2.99 per user per month or $29 per user per year on Microsoft Marketplace, with a 30-day free trial. Premium works in edit mode without a licence; unlicensed viewers see the free tier, never a blocked visual.
- Certified by Microsoft: no
- Version: 1.0.0.0
- GUID (visualType and publicCustomVisuals): `smartvisualsRiskMatrix7A41C2E9B05D4F38A6E1`

## What is free

- **Any risk matrix from 3 x 3 to 10 x 10 cells**: Square or rectangular grids, likelihood on rows or columns, level names you can rename, cell scores and grid lines.
- **Levels, probabilities or percent**: Detected automatically, with your own cut points; a value on a cut point belongs to the upper level.
- **Your bands**: 3 to 10 bands from automatic or custom thresholds, scored as likelihood times impact, likelihood plus impact or a score table.
- **Asymmetric band tables**: Paste the matrix from your policy, one line per likelihood level, so 5 x 1 does not have to equal 1 x 5.
- **Every risk visible**: Markers with risk IDs, packed so none hides another, a +n badge when a cell is full, or risk names in the cells.
- **Counts mode and cell notes**: A risk heat map of counts for dense registers, and custom annotations per cell such as "5,5: Escalate to the board".
- **Latest review and data notes**: With a Review period, the latest review is drawn. Blank and out-of-scale values are counted, never silently dropped.
- **Cross-filter, drill-through, drilldown**: Select by risk, cell or category, drill through from a cell, drill down a Category hierarchy, report page tooltips.
- **Conditional formatting both ways**: Power BI fx rules on a Colour value measure and the visual's own band colours, plus dynamic format strings and on-object formatting.
- **Templates and four themes**: Executive, Board pack (print), Minimal, Heat map (counts) and Operations (dark); SmartVisuals, Dark, Clean and Slate; a calm theme ramp or a bold red, amber and green heat.
- **Setup guide with an example**: The empty visual names the missing fields, offers template buttons and draws a built-in Helios register on request.
- **Accessibility and 20 languages**: Keyboard navigation of every cell and risk, screen reader labels, band patterns, a sortable data table and 20 languages.

## What premium adds

- **Inherent, residual, target**: Arrows between the three positions, the other positions as ghosts, rings on risks still above target, and a switch for readers.
- **Appetite and tolerance per category**: An appetite line per category, the tolerance band shaded and a ring on every breach, counted in the summary line.
- **Since last review**: Trails over past reviews, new, closed, escalated and de-escalated badges, the change of count per cell and a review picker.
- **Exposure in money**: Marker size by exposure, totals per cell and per band, an exposure heat map and the exposure above appetite.
- **Register panel**: The clicked cell's risks in a sortable panel docked beside or under the matrix, with their movement and register columns.
- **Small multiples**: One matrix per business unit or category, on shared bands so a High means the same in every panel.
- **Opportunities**: Threats and opportunities side by side, opportunities on their own mirrored grid with upside bands.

## Fields

| Field | Internal name | Takes | Needed | What it is for |
| --- | --- | --- | --- | --- |
| Risk | `risk` | Column | Optional | The risk's name; one marker per risk |
| Risk ID | `riskId` | Column | Optional | A short code drawn inside the marker (R01) |
| Likelihood | `likelihood` | Measure | Optional | Level (1, 2, 3 …), probability (0 – 1) or percent |
| Impact | `impact` | Measure | Optional | Level (1, 2, 3 …), probability (0 – 1) or percent |
| Category | `category` | Column | Optional | Colours and legend; drill down to sub-categories; appetite per category |
| Owner | `owner` | Column | Optional | Shown in tooltips, the table and the register panel |
| Review period | `period` | Column | Optional | Snapshots of the register; the latest is drawn (Since Last Review is premium) |
| Residual likelihood | `residualLikelihood` | Measure | Optional | Premium: after controls |
| Residual impact | `residualImpact` | Measure | Optional | Premium: after controls |
| Target likelihood | `targetLikelihood` | Measure | Optional | Premium: after planned actions |
| Target impact | `targetImpact` | Measure | Optional | Premium: after planned actions |
| Exposure | `exposure` | Measure | Optional | Premium: expected loss in money; sizes markers, totals per cell |
| Appetite | `appetite` | Measure | Optional | Premium: the highest acceptable score, per category |
| Tolerance | `tolerance` | Measure | Optional | Premium: the score beyond which a risk is out of tolerance |
| Threat / opportunity | `riskType` | Column | Optional | Premium: opportunities get their own mirrored grid |
| Small multiples | `facet` | Column | Optional | Premium: one matrix per business unit or category |
| Register columns | `details` | Column | Optional, up to 5 | Status, controls, actions: tooltips, table and register panel |
| Colour value | `colorBy` | Measure | Optional | Risk Colours > fx colours each marker by this value: a score, control effectiveness, days overdue |
| Tooltips | `tooltips` | Measure | Optional, up to 10 | Extra values in the tooltip |

## Format pane

Each card is a key under `visual.objects` in a PBIR visual.json; each setting is a property of it. Toggles take `true`/`false`, choices and text a value in single quotes (`'auto'`), numbers a `D` suffix (`12D`).

### Style Templates (`templates`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Template | `template` | `none` (Default), `executive` (Executive), `boardPack` (Board pack (print)), `minimal` (Minimal), `heatMap` (Heat map (counts)), `operations` (Operations (dark)), `custom` (Custom) |
| Applied | `applied` | Text |

### Matrix (`grid`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Likelihood Levels (0 = auto) | `likelihoodLevels` | Number |
| Impact Levels (0 = auto) | `impactLevels` | Number |
| Likelihood Axis | `orientation` | `vertical` (Vertical (rows)), `horizontal` (Horizontal (columns)) |
| Likelihood Values Are | `likelihoodScale` | `auto` (Auto-detect), `levels` (Levels (1, 2, 3 …)), `probability` (Probability (0 – 1)), `percent` (Percent (0 – 100)) |
| Likelihood Cut Points | `likelihoodCuts` | Text |
| Impact Values Are | `impactScale` | `auto` (Auto-detect), `levels` (Levels (1, 2, 3 …)), `probability` (Probability (0 – 1)), `percent` (Percent (0 – 100)) |
| Impact Cut Points | `impactCuts` | Text |
| Show Cell Scores | `showScores` | On / off |
| Score Font Size | `scoreSize` | Number |
| Score Colour | `scoreColor` | Colour |
| Cell Gap | `cellGap` | Number |
| Cell Corner Radius | `cellRadius` | Number |
| Cell Notes | `notes` | Text |
| Note Font Size | `noteSize` | Number |
| Note Colour | `noteColor` | Colour |
| Grid Line Width | `borderWidth` | Number |
| Grid Line Colour | `borderColor` | Colour |

### Scoring and Bands (`bands`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Score | `method` | `product` (Likelihood × impact), `sum` (Likelihood + impact), `table` (Score table (per cell)) |
| Number of Bands | `count` | Number |
| Band Names | `names` | Text |
| Band Thresholds | `thresholds` | Text |
| Per-Cell Table | `table` | Text |
| Band 1 Colour | `color1` | Colour |
| Band 2 Colour | `color2` | Colour |
| Band 3 Colour | `color3` | Colour |
| Band 4 Colour | `color4` | Colour |
| Band 5 Colour | `color5` | Colour |
| Band 6 Colour | `color6` | Colour |
| Band 7 Colour | `color7` | Colour |
| Band 8 Colour | `color8` | Colour |
| Band 9 Colour | `color9` | Colour |
| Band 10 Colour | `color10` | Colour |
| Palette | `palette` | `theme` (Theme colours), `bold` (Bold heat (green, amber, red)) |
| Cell Colour Strength (%) | `opacity` | Number |

### Markers (`markers`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Risks As | `display` | `auto` (Auto (markers, counts when crowded)), `markers` (Markers), `names` (Names in the cells), `counts` (Counts (heat map)), `exposure` (Exposure per cell (premium)) |
| Marker Size | `size` | Number |
| Shapes by Category | `shapes` | On / off |
| Marker Colour | `color` | Colour |
| Order in a Cell | `order` | `score` (Highest score first), `name` (Name), `exposure` (Exposure) |

### Data Labels (`labels`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Marker Text | `content` | `auto` (Risk ID, else a number), `id` (Risk ID), `number` (Number), `initials` (Initials of the name) |
| Font Size | `fontSize` | Number |
| Count Font Size | `countSize` | Number |
| Text Colour | `color` | Colour |

### Likelihood Axis (`likelihoodAxis`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Level Names | `names` | Text |
| Show Level Numbers | `showNumbers` | On / off |
| Title | `showTitle` | On / off |
| Title Text | `titleText` | Text |
| Font Size | `fontSize` | Number |
| Colour | `color` | Colour |

### Impact Axis (`impactAxis`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Level Names | `names` | Text |
| Show Level Numbers | `showNumbers` | On / off |
| Title | `showTitle` | On / off |
| Title Text | `titleText` | Text |
| Font Size | `fontSize` | Number |
| Colour | `color` | Colour |

### Legend (`legend`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Position | `position` | `top` (Top), `bottom` (Bottom), `right` (Right), `left` (Left) |
| Bands | `showBands` | On / off |
| Categories | `showCategories` | On / off |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Summary Line (`summary`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Data Table (`dataTable`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Matrix / Table Button | `button` | On / off |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Residual and Target (`movement`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Place Markers At | `placeAt` | `inherent` (Inherent), `residual` (Residual), `target` (Target) |
| Arrows | `arrows` | `auto` (Auto (every risk up to 15, else selected)), `all` (Every risk), `selected` (Selected risks only), `none` (None) |
| Reader Switch (Inherent / Residual / Target) | `toggle` | On / off |
| Show Other Positions | `ghosts` | On / off |
| Ring Risks Above Target | `ringAboveTarget` | On / off |
| Arrow Colour | `color` | Colour |

### Risk Appetite (`appetite`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Appetite Score (all categories) | `value` | Number |
| Tolerance Score | `tolerance` | Number |
| Appetite Lines | `lines` | `auto` (Auto (all up to two, else the selected categories)), `all` (Every category), `selected` (Selected categories only) |
| Shade the Tolerance Band | `shadeTolerance` | On / off |
| Ring Risks Above Appetite | `flagBreaches` | On / off |
| Line Width | `lineWidth` | Number |
| Category Labels | `labels` | On / off |
| Label Font Size | `labelSize` | Number |
| Line Colour | `color` | Colour |

### Since Last Review (`review`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Review Picker | `picker` | On / off |
| Trails | `trails` | On / off |
| Reviews in a Trail | `trailLength` | Number |
| New / Escalated Badges | `badges` | On / off |
| Show Closed Risks | `closed` | On / off |
| Change of Count per Cell | `delta` | On / off |
| Change Font Size | `deltaSize` | Number |

### Exposure (`exposure`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Size Markers by Exposure | `sizeByExposure` | On / off |
| Totals per Cell | `cellTotals` | On / off |
| Total Font Size | `totalSize` | Number |
| Total Colour | `totalColor` | Colour |
| Totals in the Summary | `summaryTotals` | On / off |

### Register Panel (`register`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Position | `position` | `right` (Right), `bottom` (Bottom) |
| Size (%) | `size` | Number |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Small Multiples (`smallMultiples`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Columns (0 = auto) | `columns` | Number |
| Title Font Size | `titleSize` | Number |

### Opportunities (`opportunities`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Opportunity Values | `match` | Text |
| Band Names | `names` | Text |
| Highest Band Colour | `color` | Colour |
| Heading Font Size | `headingSize` | Number |

### Footnote (`footnote`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Source | `source` | Text |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Accessibility (`accessibility`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Band Patterns | `patterns` | On / off |
| Focus Outline Colour | `focusColor` | Colour |
| Focus Outline Width | `focusWidth` | Number |
| Minimum Text Size (0 = off) | `minFontSize` | Number |

### Theme (`theme`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Theme | `selectedTheme` | `smartvisuals` (SmartVisuals), `dark` (Dark), `clean` (Clean (White)), `slate` (Slate) |
| Font | `font` | `inter` (Inter), `segoe` (Segoe UI), `arial` (Arial), `georgia` (Georgia) |
| Transparent Background | `transparentBg` | On / off |

### Category Colours (`categoryColors`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Colour | `fill` | Colour |

### Risk Colours (`dataPoint`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Colour | `fill` | Colour |
