Incident forms
Incident forms are the dialogs responders fill in at key moments of an incident’s life. Firefight ships four of them with sensible defaults, and Settings → Forms lets you tune each one, which fields appear, in what order, and which are required, without any responder retraining. Slash commands simply start showing the updated dialog.
The four lifecycle forms
Section titled “The four lifecycle forms”| Form | When responders see it |
|---|---|
| Declare | When someone declares an incident with /ff new |
| Accept | When a responder accepts an incident that arrived in triage |
| Update | When someone posts a status update with /ff update |
| Resolve | When the incident is resolved or closed with /ff resolve or /ff close |
Every form works out of the box with built-in fields such as the incident’s name, severity, and summary. You only need to touch Settings → Forms when you want to change what gets asked.
Editing a form
Section titled “Editing a form”Pick a form from the list on the left. The editor shows each field the way responders will see it, with a preview of its input. For every field you can:
- Reorder by dragging the handle next to the field.
- Show or hide with the Visible toggle. Hidden fields stay configured but disappear from the dialog.
- Require or make optional with the Required toggle. A few essential fields are locked as required and cannot be hidden or made optional.
Conditional fields
Section titled “Conditional fields”Fields can appear only when they are relevant. Add a condition to a field and it only shows when the incident’s type or severity matches. Conditions support “is one of” and “is not one of” against the incident types and severities you have configured.
Adding custom fields
Section titled “Adding custom fields”Click Add custom field on a form to attach any field defined in Settings → Custom Fields. The same field can be attached to several forms, so a value requested at declare time can be revisited at resolve time. Attached custom fields can be reordered, hidden, required, conditioned, and removed just like you would expect. Removing a custom field from a form does not delete the field definition or any values already captured.
If the field you need does not exist yet, create it first. See Custom fields for field types and option sources.