# Issues

## What is an Issue?

An Issue is created to communicate a change in functionality or availability of your services. An Issue has the following fields:

1. Affected Component
2. Affected Component Impact
3. Status Message
4. Issue Message(s)

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-f01db6a945dd869479fcb996fa8d3bf50bccbdbc%2FScreenshot%202023-06-20%20at%201.16.27%20PM.png?alt=media" alt=""><figcaption></figcaption></figure>

### Add Issue

To add an issue,

1. Navigate to **Status Page** -> select or search for your desired status page.
2. Click on the status page to navigate to the **Status Page Details page**.
3. In the Issue section, click **Add Issue**.
4. Enter the **Issue Title**, this would be the Status Message conveying the issue and impact.

{% hint style="info" %} <mark style="color:blue;">**Note**</mark>: We only support editing the Issue Title for historical issues.
{% endhint %}

1. Select the overall **Page Status**.
2. Next, select the **Component Group** and the **Impact**.
3. Add the **Issue State** and its messaging.

{% hint style="info" %} <mark style="color:blue;">**Note**</mark>: You can manually select the Date & Time of the Message Update.
{% endhint %}

1. Once you have added all your preferred settings, click **Save**.

<div><figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-5f6dd32a36ab60b54fe1ca5c03a6018391f88c8a%2FIssues_1.png?alt=media" alt="Add an Issue in Status Page" width="563"><figcaption><p>Image. Add Issue</p></figcaption></figure> <figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-4a7f1aed6f9ba09898021826010387270fe32e8c%2FIssues_2.png?alt=media" alt="Add an Issue State &#x26; Messaging in Status Page" width="563"><figcaption><p>Image. Add Issue State &#x26; Messaging</p></figcaption></figure></div>

### Update Issue States & Messages

Once your issue is created, you can add update the Issue States & Messages, to do so:

1. Hover over the Issue from the Issue List -> **Update State & Messages**
2. You can edit an existing message or add another update.
3. Moreover, you can change the State by clicking on them.

{% hint style="warning" %} <mark style="color:orange;">**Important**</mark>: Before you change the Issue State to Resolved, we recommend you change the Page and Component Status from non-operational.\
\
Resolving it would mean you are closing this issue and you will no longer be able to add new updates to this issue.
{% endhint %}

{% hint style="info" %} <mark style="color:blue;">**Note**</mark>: After the resolution of the issue, the only available option for the Page and Component Status is to set it as "Operational."
{% endhint %}

<div><figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-3999b7606d125e5a50f0bfb0b819105c38284d51%2FIssues_3.png?alt=media" alt=""><figcaption><p>Image. Update Issue States</p></figcaption></figure> <figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-167be2ce3ce843cc59a497603eb0c12985771cba%2FIssues_4.png?alt=media" alt=""><figcaption><p>Image. Update Issue Message</p></figcaption></figure></div>

### Delete an Issue

To delete an Issue from the Status Page,

1. Navigate to **Status Page** -> select or search for your desired status page.
2. Click on the status page to navigate to the **Status Page Details page**.
3. In the Issue section, against the Issue you wish to delete, click **More options**.
4. Click **Delete**, and a confirmation model will appear.
5. Click **Delete** again, to confirm.

{% hint style="warning" %}
**Important**: This action would remove the Issue from the recorded Issue History.
{% endhint %}

*Have any questions?* [*Ask the community*](https://community.squadcast.com/view/home)*.*