Built-In Forms
Rootly comes with eight essential, built-in forms that cannot be deleted. The forms each cover a different stage of an incident and scheduled maintenance lifecycle.
You can access the built-in forms by navigating to Configurations > Forms & Fields.
The New Incident form is displayed whenever the user first declares an incident on Slack (via /rootly new command) or on the Rootly web UI (via Create Incident button).
The Update Incident form is displayed whenever the user attempts to update an incident on Slack (via /rootly update command or Update button) or on the Rootly web UI (via Edit button).
The Incident Mitigation form is displayed whenever the user attempts to mitigate an incident on Slack (via /rootly mitigate command) or on the Rootly web UI (via Mitigate button).
The Incident Resolution form is displayed whenever the user attempts to resolve an incident on Slack (via /rootly resolve command) or on the Rootly web UI (via Resolve button).
The Incident Cancellation form is displayed whenever the user attempts to cancel an incident on Slack (via /rootly cancel command) or on the Rootly web UI (via Cancel button).
The Incident Retrospective Form is displayed after the incident is resolved and the user enters the Gather & Confirm Data step of the retrospective. This form is only accessible from the Rootly web UI.
The New Maintenance Incident form is displayed whenever the user first declares a scheduled maintenance on Slack (via /rootly maintenance command) or on the Rootly web UI (via Schedule Maintenance button).
The Update Maintenance Incident form is displayed whenever the user attempts to update a scheduled maintenance on Slack (via /rootly update command or Update button) or on the Rootly web UI (via Edit button).
You'll notice that the trigger points for scheduled maintenance is exactly the same as for incidents. Rootly will be able to recognize the context and display the appropriate form. For example when /rootly update is ran,
- If it was ran in an incident channel, then Update Incident form will be displayed
- If it was ran in an maintenance channel, then the Update Maintenance Incident form will be displayed

To begin editing a form, select the Configure button under the form you'd like to edit.
You'll be navigated to the edit form page of the selected form. The left side of the page is the edit pane where you can edit what fields are displayed and how they are displayed. The right side of the page is the preview of the form.
You can switch between Slack and Rootly web UI versions of the form by using the tabs at the top of the page.
You can mark a field as required by hovering over the right hand side of the field name. An asterisk (*) will appear and if selected, will make the field a required field on that specific form.
You can rearrange the order of the fields by dragging them by the 6-dot area.
You can remove a field by clicking on the minus symbol. Removed fields will not appear on the selected form.
You can add a new field by clicking on the Add Field button at the bottom of the page.

This will open a side pane where you can select the desired fields to add to the form. Only enabled fields are available to be selected on this panel. Please see Built-In Fields and Custom Fields pages to see how to enable/disable incident fields.

You quickly match the Slack and Rootly web UI displays of the form by clicking the Copy fields from Web form or Copy fields from Slackbuttons.
The preview is generated in real-time and it is interactive. This is a great way to test out the behvior of each field.
If you need help or more information about this page, please contact [email protected] or start a chat by navigating to Help > Chat with Us.
