# Participant Alerts

Source: https://docs.astalty.com.au/guide/participants/profile/participant-alerts

> Add alerts to flag important information that affects a Participant's support.

Participant Alerts are used to communicate important information that may directly impact the support provided to a Participant. When creating an Alert, adding a **Title** is optional; however, the **Content** field is required.

## Creating Alerts

To add an Alert, navigate to the [Participant's profile](https://app.astalty.com.au/participants) and select **Add Alert**.

![The top of a Participant's profile, with an arrow pointing to the highlighted Add Alert button above the Participant Details card.](https://docs.astalty.com.au/assets/alert.png)

Once the form opens, complete the available fields and select **Create Alert** when you are ready. The purpose of each field is outlined below.

![The Create Alert drawer with two highlighted sections: Alert Details, holding the Title Noah is currently in hospital and a text editor for the message, and Alert Type, with Warning selected rather than Info.](https://docs.astalty.com.au/assets/alert-1.png)

### Title

This will be the main heading of the Alert. For example: *Barney is currently in hospital*.

### Content

The Content field allows you to add further details about the Alert. It is best practice to keep this to one or two short sentences.

You can create an Alert **Note Template** for repeatable wording. See [Note Templates](https://docs.astalty.com.au/guide/settings/tasks-notes-settings/note-templates).

### Alert Type

There are currently two Alert types available:

- Info - displayed in blue
- Warning - displayed in amber

Aside from the colour, there is no functional difference between Alert types.

![The lower part of the Create Alert drawer, with the Visibility tick boxes Visible to Support Workers and Visible when Scheduling, and the Notifications tick boxes Notify Primary Coordinator and Notify Others highlighted, and an arrow pointing to Create Alert.](https://docs.astalty.com.au/assets/alert-2.png)

### Alert Visibility

If Scheduling is enabled, **Visible to Support Workers** shows the Alert in the mobile app, while **Visible when Scheduling** shows it in the Participant details used while scheduling Supports.

### Alert Notifications

When creating an Alert, the Notifications section is located at the bottom of the form, with the following selections available:

#### Primary Coordinator

**Notify Primary Coordinator** emails the Primary Coordinator and sends an in-app notification. It is on by default when creating an Alert.

#### Notify Others

If you select **Notify Others**, you will be prompted to choose additional team members or User Groups to receive a notification when the Alert is created.

![The Notifications section of the Create Alert drawer with Notify Primary Coordinator and Notify Others ticked, and the highlighted Who else would you like to notify? area showing Team Members and Groups dropdowns.](https://docs.astalty.com.au/assets/alert-7.png)

### After Creating the Alert

Once created, the Alert will appear at the top of the Participant's profile and will be displayed according to the selected Alert type colour.

![A Warning Alert titled Noah is currently in hospital, shown in amber at the top of a Participant's profile with its message and date, and an arrow pointing to its Visible to Support Workers label.](https://docs.astalty.com.au/assets/alert-6.png)

The Alert will include:

- Alert Title and Content
- The date the Alert was created
- Visibility tags, indicating whether it is visible to Support Workers and/or Schedulers

If notifications were enabled, the Primary Coordinator receives email and an in-app notification. Team Members and Groups selected under **Notify Others** receive email. The same notification controls are available when updating an Alert.

> **Automatic Note Creation for Alerts**
>
> When an Alert is added to a Participant's profile, Astalty automatically creates a Note with the same content on the Participant's profile. This Note remains on the profile after the Alert has been archived, ensuring there is an ongoing record that the Alert existed.

## Updating an Alert

After an Alert has been created, you can update its details by selecting the **edit icon**.

![An Info Alert shown in blue at the top of a Participant's profile, with the pencil edit icon at its top right highlighted.](https://docs.astalty.com.au/assets/alert-edit-1.png)

The Alert form will open, allowing you to update the Alert with any required changes.

![The Edit Alert drawer showing the Alert's Title and message, Alert Type set to Info, both Visibility options ticked, the Notifications options unticked, and a Save button.](https://docs.astalty.com.au/assets/edit-alert-2.png)

## Removing an alert

Alerts can be removed by selecting the **archive icon**.

![An Info Alert at the top of a Participant's profile, with the archive icon at its top right, beside the edit icon, highlighted.](https://docs.astalty.com.au/assets/archive-alert-1.png)

You will be prompted to provide a reason for archiving the Alert.

Archiving an Alert does not remove the Note that Astalty created with it. Where an archived Alert is displayed, select **Unarchive Alert** to make it active again.

![A Confirm prompt asking whether to archive the Alert and noting the associated Note is not affected, with a reason typed in the highlighted Reason for archive field and an arrow pointing to Archive.](https://docs.astalty.com.au/assets/archive-alert-2.png)

Archived Alerts can be viewed in the **Participant Alerts Report** by setting the **Alert Status** filter to **Archived**. For more information, refer to the [Participant Alerts Report](https://docs.astalty.com.au/guide/reports/participant-alerts-report) guide.

![The Participant Alerts Report with an arrow pointing to the Alert Status is Archived filter, and the archived Alert highlighted in the list below.](https://docs.astalty.com.au/assets/alerts-report-1.png)
