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

# Create a hazard

> Add a hazard to your hazard log: describe it, add its causes and controls, and score its initial and residual risk.

<Note>
  **Quick summary**

  * Click **New Hazard** and work through 6 stages, from the hazard itself to its residual risk.
  * **Save & Exit** updates the working log only. To make it official, [approve a version](/clinical-safety/hazard-log-approvals).
  * You need a written justification from an *Undesirable* residual rating (3 on the default matrix) upwards, or the hazard won't save.
</Note>

<Warning>
  Clicking through the stages of an existing hazard can save changes to it. Open a hazard only when you intend to work on it.
</Warning>

## Before you start

* Open **Clinical Safety → Hazard Log** and pick your products under *Product*. The table and any new hazard start with them selected.
* A hazard can apply to several products. It appears in each product's log, and each log is approved and published separately.

## Add a hazard

<Steps>
  <Step title="Describe the hazard">
    Click **New Hazard** and fill in the **Hazard** stage. You can add causes once the required fields are set.

    | Field | What to enter |
    | - | - |
    | **Products** (required) | The products the hazard applies to |
    | **Hazard ID** | Suggested for you, following your [hazard ID pattern](/clinical-safety/hazard-ids-and-statuses#hazard-ids) |
    | **Tags** (optional) | Labels for filtering, such as Patient Impact or Usability |
    | **Hazard** (required) | The hazard itself, in a short line |
    | **Description / Effect** | A short description, or the effect associated with the hazard |
    | **Harm** (required) | The effect in the care setting, and the potential clinical impact or harm to the patient |

    <Frame caption="The Hazard stage filled in, with the six stages across the top.">
      <img src="https://mintcdn.com/assuric-docs/dWbvfe5lTrtlaI9n/images/clinical-safety/create-hazard-complete.png?fit=max&auto=format&n=dWbvfe5lTrtlaI9n&q=85&s=9af921622ce282b89c527a60b8979a37" alt="The Hazard stage of a new hazard with products, hazard ID, hazard, description and harm completed" width="3810" height="3039" data-path="images/clinical-safety/create-hazard-complete.png" />
    </Frame>

    **Suggest Hazards** and **Suggest Harm** draft from your [product description](/getting-started/adding-a-product). To draft a whole hazard in plain English, [use AI](/clinical-safety/hazard-log-with-ai).
  </Step>

  <Step title="Add the causes">
    Add each cause in one of the three ways shown below: type a new one, link or copy an existing one, or copy in an AI suggestion.

    <Frame caption="**1** Type a new cause and click Add. **2** Or link or copy an existing cause, filtering by product. **3** Suggest Causes offers AI suggestions.">
      <img src="https://mintcdn.com/assuric-docs/bnvpDj8ibnBhFFpx/images/clinical-safety/hazard-causes-stage-add-cause.png?fit=max&auto=format&n=bnvpDj8ibnBhFFpx&q=85&s=8920b41aa346aba5d1734f942eda829b" alt="The Causes stage of a hazard with the New Cause for this Hazard field and Add button, the Link or copy existing Causes to this Hazard panel with its product filter, and the Suggest Causes button" width="4494" height="2391" data-path="images/clinical-safety/hazard-causes-stage-add-cause.png" />
    </Frame>

    <Warning>
      A [linked cause](/clinical-safety/causes-and-controls#copy-or-link) is one cause in several places, so editing or deleting it changes it everywhere.
    </Warning>
  </Step>

  <Step title="Add the existing controls">
    For each cause, add the controls already in place, in the same three ways as causes.

    <Frame caption="**1** Type a control and click Add. **2** Or link or copy one from Link or copy existing Controls to this Cause, using its filters. **3** Suggest Controls offers AI suggestions.">
      <img src="https://mintcdn.com/assuric-docs/bnvpDj8ibnBhFFpx/images/clinical-safety/existing-controls-stage.png?fit=max&auto=format&n=bnvpDj8ibnBhFFpx&q=85&s=54667073030cee877de3bda58030ccd9" alt="The Existing Controls stage with one cause expanded, the New Existing Control field and Add button, the Link or copy existing Controls to this Cause panel with its filters, and the Suggest Controls button" width="4494" height="2997" data-path="images/clinical-safety/existing-controls-stage.png" />
    </Frame>

    [Attach evidence](/clinical-safety/causes-and-controls#evidence) to each control now, or later from the **Controls** tab.
  </Step>

  <Step title="Set each control's details">
    For each control, set:

    | Field | Options |
    | - | - |
    | **Responsibility** | *Manufacturer* (you operate it) or *Deploying Org* (the deploying organisation operates it, so it's a [transferred control](/clinical-safety/exporting-a-hazard-log#what-customers-download)) |
    | **Control Type** | The kind of control, chosen from a list |
    | **Control Status** | Yours to define, for example *Awaiting Evidence* or *Done* |

    <Frame caption="The control form, opened from an existing control. **1** Responsibility, **2** Control Type and **3** Control Status.">
      <img src="https://mintcdn.com/assuric-docs/bnvpDj8ibnBhFFpx/images/clinical-safety/existing-control-form.png?fit=max&auto=format&n=bnvpDj8ibnBhFFpx&q=85&s=d471d256a95a04598018ad7cfff825c4" alt="The Edit Control form with the Responsibility, Control Type and Control Status fields" width="1572" height="2124" data-path="images/clinical-safety/existing-control-form.png" />
    </Frame>
  </Step>

  <Step title="Score the initial risk">
    Rate the hazard with its existing controls in place (**View Causes** lists them). Set *Severity* and *Likelihood* with the sliders, or click a grid cell to set both. *Initial Risk Justification* is optional.

    The slider descriptions are cut short: **Learn More** gives Assuric's full definitions, and [Risk scales and thresholds](/clinical-safety/risk-scales-and-thresholds) has the matrix.

    <Frame caption="Likelihood and severity selected, the matching grid cell highlighted, and the Overall Rating filled in.">
      <img src="https://mintcdn.com/assuric-docs/dWbvfe5lTrtlaI9n/images/clinical-safety/initial-risk-selected.png?fit=max&auto=format&n=dWbvfe5lTrtlaI9n&q=85&s=9a75dfc1564af2284d6dc8a4392ed5a3" alt="The risk stage with both scales set and the overall rating calculated" width="2439" height="492" data-path="images/clinical-safety/initial-risk-selected.png" />
    </Frame>
  </Step>

  <Step title="Add additional controls">
    Under each cause, add controls that bring the risk down further with **New Additional Control**. They take the same fields as existing controls.

    <Frame caption="**1** Type an additional control under a cause and click Add. **2** Or link or copy an existing control from the panel.">
      <img src="https://mintcdn.com/assuric-docs/bnvpDj8ibnBhFFpx/images/clinical-safety/additional-controls-stage.png?fit=max&auto=format&n=bnvpDj8ibnBhFFpx&q=85&s=74a9d3194481645f6cce197119e67ed0" alt="The Additional Controls stage with the New Additional Control field and Add button, and the Link or copy existing Controls to this Cause panel with its filters" width="4494" height="1563" data-path="images/clinical-safety/additional-controls-stage.png" />
    </Frame>
  </Step>

  <Step title="Score the residual risk and set the status">
    Rate what remains with the additional controls in place (**View Causes and Controls** lists them), setting *Severity* and *Likelihood* as before.

    <Warning>
      From an *Undesirable* residual rating ([3 on the default matrix](/clinical-safety/risk-scales-and-thresholds#what-happens-at-3-and-above)), *Residual Risk Justification* becomes required. Confirm whether the risk is as low as reasonably practicable (ALARP) and give a risk-benefit justification, or the hazard won't save.
    </Warning>

    Set *Hazard Status* ([a default or one you've added](/clinical-safety/hazard-ids-and-statuses#statuses)), then click **Save & Exit**. This updates the working log only.

    <Frame caption="The bottom of the Residual Risk stage. **1** Hazard Status. **2** Save & Exit.">
      <img src="https://mintcdn.com/assuric-docs/bnvpDj8ibnBhFFpx/images/clinical-safety/residual-risk-stage-status.png?fit=max&auto=format&n=bnvpDj8ibnBhFFpx&q=85&s=d2feb229841898f5acdaca0fa8da29c3" alt="The Residual Risk stage scrolled to the bottom, showing the residual rating, the justification, the Hazard Status selector and the Save & Exit button" width="3393" height="2307" data-path="images/clinical-safety/residual-risk-stage-status.png" />
    </Frame>
  </Step>
</Steps>

When the product's log is ready, [approve a version](/clinical-safety/hazard-log-approvals), then [share and publish it](/clinical-safety/sharing-and-publishing).

<Tip>
  **What we recommend**

  Finish one hazard before you start the next.
</Tip>

## Related articles

<Columns cols={2}>
  <Card title="Causes, controls and evidence" icon="link" href="/clinical-safety/causes-and-controls">
    The linking model, and how evidence attaches to controls.
  </Card>

  <Card title="Manage hazards" icon="list-checks" href="/clinical-safety/managing-hazards">
    Archive instead of deleting, and changing shared items safely.
  </Card>
</Columns>


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