> ## 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.

# Manage hazards

> Keep the hazard log current: archive instead of deleting, work through a change, and change or delete shared causes and controls safely.

<Note>
  **Quick summary**

  * When your product or its use changes, update the hazards it affects, then [approve a new version](/clinical-safety/hazard-log-approvals).
  * Editing or deleting a linked cause or control changes it everywhere, so check **⋯ → References** first.
  * Archive a hazard, cause or control instead of deleting it: it stays available for audit.
</Note>

## Archive instead of deleting

An archived hazard, cause or control:

* gets an *(ARCHIVED)* prefix on its ID;
* stays available for audit;
* drops out of the default view until you set the funnel's *Archived* filter to *Yes*.

[Versions you approve](/clinical-safety/hazard-log-approvals) from then on leave out an archived hazard.

To archive a cause, click **⋯ → Archive** on its row in the **Causes** tab, change the defaults if you want a different outcome, then click **Archive cause** to confirm.

| Option | What it does |
| - | - |
| **Unlink from hazards** | Removes the cause from its hazards (ticked by default) |
| **Unlink controls** (under *Linked controls*) | Removes the cause from its controls (selected by default), though a control shared with other causes stays linked to them |
| **Archive the controls only linked to this cause** | Archives the controls no other cause uses |

To archive a control, click **⋯ → Archive** on its row in the **Controls** tab. *Unlink from all mapped causes* is ticked when the dialog opens: untick it to keep the links, then click **Archive control** to confirm.

<Frame caption="Archive control for CTRL-047, which is linked to one cause. Unlink from all mapped causes is ticked when the dialog opens.">
  <img src="https://mintcdn.com/assuric-docs/7KuSiUgcJ3qf7UoR/images/clinical-safety/archive-control-dialog.png?fit=max&auto=format&n=7KuSiUgcJ3qf7UoR&q=85&s=6d07983ed036e2684b3be82b521bc791" alt="The Archive control dialog for CTRL-047 with Unlink from all mapped causes ticked, and the Delete, Cancel and Archive control buttons" width="1729" height="1192" data-path="images/clinical-safety/archive-control-dialog.png" />
</Frame>

## When something changes

When a customer reports a problem, a release changes how the product behaves or an incident shows a control didn't hold, work through the hazards it touches:

<Steps>
  <Step title="Find the affected hazards">
    [Filter the log](/clinical-safety/hazard-log-overview#read-the-hazard-log) by product, or open a cause or control and check **⋯ → References**.
  </Step>

  <Step title="Update the hazards">
    Update the causes, controls and evidence, and re-score [residual risk](/clinical-safety/hazard-log#add-a-hazard) if the controls changed. Then set each hazard's [status](/clinical-safety/hazard-ids-and-statuses#statuses) to match where it now stands.
  </Step>

  <Step title="Approve a new version">
    [Approve a new version](/clinical-safety/hazard-log-approvals) with *Republish options* ticked, so the published copies move to it.
  </Step>
</Steps>

### Editing a linked cause or control

The change appears immediately in every hazard using it, including hazards on other products.

Evidence works the same way: replacing a file updates it everywhere the control is used, including in any version you're preparing to approve.

### Deleting a linked cause or control

<Warning>
  **Deleting a linked cause or control deletes it everywhere.** Deleting a control also deletes its attached evidence. To stop using it on just one hazard, remove it from that hazard instead. To take it out of use but keep it for audit, [archive it](#archive-instead-of-deleting).
</Warning>

Before you delete, check **⋯ → References**, which lists by ID every hazard using a cause, or every cause and hazard using a control. The delete confirmation shows the same list.

<Frame caption="Deleting a shared control warns you what else it is attached to. Cancel is the safe way out.">
  <img src="https://mintcdn.com/assuric-docs/dWbvfe5lTrtlaI9n/images/clinical-safety/shared-control-delete-warning.png?fit=max&auto=format&n=dWbvfe5lTrtlaI9n&q=85&s=9fb5a7dd7edd57bb70a37571891008a2" alt="The delete confirmation for a shared control, listing where it is used" width="1530" height="873" data-path="images/clinical-safety/shared-control-delete-warning.png" />
</Frame>

## Related articles

<Columns cols={2}>
  <Card title="Hazard log overview" icon="flame" href="/clinical-safety/hazard-log-overview">
    How the hazard log fits together, and how to read its table.
  </Card>

  <Card title="Causes, controls and evidence" icon="link" href="/clinical-safety/causes-and-controls">
    The linking model behind what propagates where.
  </Card>
</Columns>


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