> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rootly.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Scheduling Maintenance Incidents
> Learn how to schedule and manage maintenance incidents for planned service interruptions, including Slack channel creation and status page integration.
Maintenance incidents allow your teams to plan, coordinate, and communicate progress of your planned downtime and maintenance windows.
Create a Maintenance Incident in the Rootly web app under **Incidents** > **Maintenance**.
Rootly does not automatically generate a Slack channel for Maintenance Incidents. Create one by selecting the Slack icon under the incident title in the web app.
After the maintenance incident has been created, share it on your [Status Pages](/configuration/status-pages).
## Schedule a Maintenance Incident from the web app
Go to **Incidents > Maintenance** and click **Schedule Maintenance** in the top-right corner.
Fill in the *Maintenance Incident* form. If you want to gather more details, the form can be completely customized in the **Configuration** > **Forms** section of the web application.
The default *Maintenance Incident* form includes:
| Field | Content |
| ------------------------------------- | -------------------------------------------------------------------------------------------- |
| Title | Title of the incident. This will be used to create the channel name along with today's date. |
| Summary | A summary of the incident. |
| [Severity](/configuration/severities) | Defaults: Severity level from SEV3 to SEV0. |
| [Type](/configuration/incident-types) | The type of incident. Defaults: Cloud, Security, Customer facing, Default. |
| [Services](/configuration/services) | The service or services impacted. |
Click **Create Incident** to save.
## Schedule a Maintenance Incident from Slack
Enter the Slack command **/rootly maintenance**. Press *enter* or click *the paper plane icon* to run the command and open the *maintenance incident* form.
Fill in the *maintenance incident* form. *Scheduled for* and *Scheduled until* dates and times are required.
Most of the fields in the *maintenance incident* form can be customized and new fields can be added. If you want to gather more details, the form can be completely customized in the **Configuration** > **Forms** section of the web application.
The default *maintenance incident* form includes:
| Field | Content |
| ------------------------------------- | -------------------------------------------------------------------------------------------- |
| Title | Title of the incident. This will be used to create the channel name along with today's date. |
| Summary | A summary of the incident. |
| [Severity](/configuration/severities) | Defaults: Severity level from SEV3 to SEV0. |
| [Type](/configuration/incident-types) | The type of incident. Defaults: Cloud, Security, Customer facing, Default. |
| [Services](/configuration/services) | The service or services impacted. |
Click **Schedule** to save.
The maintenance incident is now available in the Rootly web app. To manage the incident in Slack, select *View in Rootly,* then click the Slack icon under the incident title.
## Update a maintenance incident
Once a maintenance incident is scheduled, you can change its status, edit its details, assign roles, and open a Slack channel for it from the incident view.
### Change the status
Maintenance incidents can have the following statuses:
* Planning
* Scheduled
* In Progress
* Verifying
* Completed
* Cancelled
Change the status by clicking **Incident Status** in the top-right corner, or in Slack using the `/rootly status` command.
### Update Details
Click **Edit** in the top-right corner to update the incident.
Default fields include:
| Field | Content |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Scheduled start and end time | The planned time for the maintenance to take place. |
| Title | The title of the maintenance incident. This will only be visible in the Rootly web app or the incident Slack channel (if applicable). |
| [Severity](/configuration/severities) | Defaults: Severity level from SEV3 to SEV0. |
| [Type](/configuration/incident-types) | The type of incident. Defaults: Cloud, Security, Customer facing, Default. |
| [Services](/configuration/services) | The service or services impacted. |
| [Environments](/configuration/environments) | The environment the incident will impact. For example, Dev or Production. |
| [Functionalities](/configuration/functionalities) | Specific functionalities impacted. For example, Checkout or Search. |
| [Teams](/configuration/teams) | The relevant teams involved in this maintenance incident. |
The form can be edited from **Configuration** > **Forms & Fields** > **Update Maintenance Incident.**
### Assign Roles
Pre-assign roles to this maintenance incident by selecting "Assign Roles" under the incident title.
### Create a Slack channel
Select the Slack icon under the incident title to create a Slack channel for this maintenance incident.
## Publish Your Maintenance Incident to a Status Page
Communicate your upcoming and active maintenance windows to your stakeholders through the Rootly Status Page.
Navigate to your maintenance window, select the **Status Page** tab, then **Publish Incident**.
Select the status page you'd like to publish an update to and fill in the subsequent information to include in the update.
Rootly will automatically surface any Maintenance Windows at the top of the status page.
Further, any services attached to your Maintenance Window will automatically be shown as **In Maintenance** if the update published to the status page is either **In Progress** or **Verifying.**
To give you full control over how maintenance windows are communicated to your stakeholder, Rootly will not automatically update your status page based on the maintenance incident's current status: updates must be manually published to the status page.
## Building Workflows for Maintenance Incidents
You can build automations for your Maintenance Incidents using [Rootly's Workflow builder](/workflows/incident-workflows). Follow the instructions to create a workflow in the linked documentation.
To create a workflow specific to Maintenance Windows, ensure your workflow has a **Kind** condition set to **Scheduled Maintenance** so that the workflow will only fire on your maintenance incidents.
## Converting a maintenance incident
Sometimes, unexpected complexity might occur during your maintenance incident, and it requires a regular incident to be declared.
Rootly lets you convert an existing maintenance incident into a regular incident directly in Rootly Web, or via Slack.
## Converting to a regular incident on web
While viewing your Maintenance Incident on web, select (...), then **Convert to incident**.
Clicking on this button will trigger your Rootly **Create Incident** form, as well as a 'Reason for conversion' field for your commanders to fill out to give additional context for why the incident is being converted. The information provided in this field will be added to the incident's timeline.
## Converting to a regular incident on Slack
To convert your maintenance incident on Slack, in your maintenance incident's Slack channel use the `/rootly convert maintenance` command.
This will trigger your Rootly **Create Incident** form, as well as a 'Reason for conversion' field for your commanders to fill out to give additional context for why the incident is being converted. The information provided in this field will be added to the incident's timeline.
Once your maintenance incident is converted to a regular incident, all of your related automations and workflows will trigger much like they do when a new incident is created.
***
## Related Pages
The umbrella page covering how incidents work end-to-end.
Where maintenance windows get communicated to customers.
How maintenance-incident updates land on the status page.