Incidents
The Incidents page is a single register for anything that went wrong: security incidents, health and safety (HSE) incidents, quality incidents, and environmental incidents. Each incident gets an automatic number, a severity, and a lifecycle from first report through investigation and containment to closure. Serious incidents can be escalated into a CAPA with one click.
Before you start
- The Incidents module (category: Health, safety & environment) must be enabled in Settings > Modules. It is on by default. The page lives at
/incidentsand appears in the side nav as Incidents. - You need to be a member of an organization. Any member can report and update incidents. Only admins can change module settings.
- To use Raise CAPA, the CAPA module must also be available (it is on by default).
Report an incident
- Open Incidents in the side nav and click Report Incident.
- Fill in the dialog:
- Title (required): what happened, in one line.
- Description: what happened, who was involved, and the impact.
- Category: Security, HSE, Quality, Environmental, or Other. Defaults to Other. Security incidents map to ISO 27001 A.5.24 to A.5.28; HSE incidents map to ISO 45001.
- Severity: Minor, Moderate, Major, or Critical. Defaults to Moderate.
- Occurred on: the date the incident happened.
- Detected on: the date it was noticed. These can differ, for example a security breach found weeks later.
- Location: site, area, or system.
- Reported by: the name of the person who reported it.
- Immediate action taken: the containment or first response already done.
- If you pick the HSE category, four extra fields appear:
- Injury type: for example laceration or sprain.
- Body part: for example left hand.
- Lost time (days): whole number of work days lost.
- Recordable incident: check this if the incident counts as recordable under your reporting rules.
- Click Report incident. The incident is saved with status Reported and gets an automatic number in the form INC-0001, INC-0002, and so on, sequential per organization.
Read the register
- The stats bar shows four counts across the whole register: Total, Open, Critical, and HSE recordable.
- Filter the list with the Status, Category, and Severity dropdowns. The stats bar keeps showing whole-register numbers even while filters are applied.
- Each row shows the incident number and title, the description, and tags: category, severity, status, the occurred or detected date, location, red lost-day tags for HSE incidents with lost time, a Recordable tag, and a CAPA tag once a CAPA is linked.
Move an incident through its lifecycle
The lifecycle is: Reported > Investigating > Actions in progress > Closed. Each row shows one forward button for the next step:
- On a Reported incident, click Investigate. Status becomes Investigating.
- On an Investigating incident, click Actions. Status becomes Actions in progress, and CompStack stamps the containment time on the record.
- On an incident with Actions in progress, click Close. Status becomes Closed, and CompStack stamps the closure time.
The containment and closure timestamps together give you the incident timeline: reported, contained, closed. They are stamped once and are not overwritten if you pass through a status again.
Edit an incident
- Click the pencil (edit) button on the row.
- The same dialog opens with one extra field that only appears when editing: Root cause, the underlying cause found during the investigation.
- Change any field and click Save. Switching the category away from HSE clears the injury fields.
Raise a CAPA from an incident
- Move the incident past Reported first. The Raise CAPA button appears once the incident is Investigating or later and has no CAPA linked yet.
- Click Raise CAPA. CompStack creates a CAPA titled "Incident INC-XXXX:
", copies the incident details and immediate action into the CAPA description, and links it back to the incident. - The row now shows a CAPA tag with the CAPA number, and the Raise CAPA button disappears. Manage the corrective action itself from the CAPA board.
Try it
- Click Report Incident, enter only a title, and save. Expected: a new row with number INC-0001 (or the next number), status Reported, severity Moderate, category Other.
- Report a second incident with category HSE. Expected: the Injury type, Body part, Lost time (days), and Recordable incident fields appear in the dialog.
- Set Lost time to 3 and save. Expected: the row shows a red "3 lost days" tag.
- Check Recordable incident and save. Expected: the row shows a Recordable tag and the HSE recordable stat increases by one.
- Click Investigate on a Reported incident. Expected: status tag changes to Investigating and a toast confirms the change.
- Click Actions, then Close. Expected: status walks through Actions in progress to Closed, and the Open stat drops by one.
- On an Investigating incident, click Raise CAPA. Expected: a toast names the new CAPA, and the row shows a cyan CAPA tag. The Raise CAPA button is gone.
- Filter Status to Closed. Expected: only closed incidents show, but the stats bar totals do not change.
If something goes wrong
- Incidents is missing from the side nav: the Incidents module is turned off. An admin can enable it in Settings > Modules under Health, safety & environment. Visiting
/incidentswhile it is off redirects you to the dashboard. - "No incidents reported" empty state: nothing has been logged yet. Click Report Incident to add the first one.
- "No incidents match the filters": your Status, Category, or Severity filter is excluding everything. Set the filters back to All to see the full register.
- Raise CAPA is not visible: the button only appears when the incident is past Reported and has no CAPA linked yet. Click Investigate first, or check for an existing CAPA tag on the row.
- Injury fields are missing: they only show when the Category is HSE. Other categories do not carry injury data.
- Lost time will not accept text: the field accepts digits only. Enter a whole number of days.
- Permission errors when saving: you need a member role in the organization. Ask an admin to check your membership in Settings > Members.