Format and Upload an Escalation List CSV

GoGuardian Beacon 24/7 uses an Escalation List CSV to determine which staff members are called when an Active Planning alert is generated. The CSV defines each contact’s phone number, priority, and availability schedule. You can update the CSV at any time. There is no limit to the number of uploads, but a correctly formatted CSV is required at all times.

Review CSV Requirements

Each row in the CSV represents one escalation list contact. The following fields are required or optional as noted.

Field	Required	Description
Name	Required	Full name of the staff member. Example: `Wally GoGuardian`
Email	Required	Must match an existing user in Org Management who is added to this Beacon deployment. Example: `wally@goguardian.com`
Phone Number	Required	Must be a direct number the contact will answer. Avoid general office numbers. Must match the number listed for this user in Org Management.
Priority	Required (except Last Responder)	Numeric priority. `1` is the highest priority and is contacted first.
Weekday Start	Optional	Start time of availability on weekdays. Use 24-hour format in your local timezone. Example: `15:30`
Weekday End	Optional	End time of availability on weekdays. Use 24-hour format in your local timezone. Example: `23:30`
Weekend Start	Optional	Start time of availability on weekends. Use 24-hour format in your local timezone. Example: `08:15`
Weekend End	Optional	End time of availability on weekends. Use 24-hour format in your local timezone. Example: `20:00`
Last Responder	Optional	Set to `1` for the contact to call if no other escalation list member can be reached. All other rows must have a value of `0` or leave this field blank. The Last Responder’s priority and schedule fields must be left blank.

Understand Scheduling Notes

It is recommended that your escalation list covers a full 24-hour period on both weekdays and weekends, though this is not required.
A start time can be later than the end time to represent an overnight shift. For example, a start time of 20:00 and an end time of 08:00 means the contact is available from 20:00 to midnight, and again from midnight to 08:00.
To schedule a contact for a full 24 hours, set the start time to 00:00 and the end time to 24:00.
It is recommended that the escalation list include at least two contacts.
Escalation lists are for school staff only. Parents cannot be added to a school escalation list.

Upload the CSV

Go to Settings, then select Staff Notifications.
Click the 24/7 Staff Notifications tab.
Click Upload Escalation List CSV. A popup window appears. Select your CSV file to upload it.

If the CSV contains formatting errors, Beacon displays detailed information about what needs to be corrected before the upload can proceed.

Upload Status States

After uploading, Beacon displays one of three status states:

Status	Meaning
EMPTY	The uploaded CSV contains no coverage. A warning banner appears at the top of your Beacon page until a CSV with at least partial coverage is uploaded.
PARTIAL	The CSV was uploaded successfully but does not cover the full 24-hour period. A notification appears on the Staff Notifications settings page. Phone call escalations will function for the hours that are covered.
FULL	The CSV covers the full required period. No warnings are displayed. Phone call escalations are fully operational.

Download CSV Templates

Use the following resources to build and validate your CSV:

Resources

Escalation Lists

Configure tier-based escalation lists for email and text notifications.

Add and Manage Beacon Users

Add users to a deployment before adding them to an escalation list.

Beacon User Roles and Permissions

Review which roles can manage escalation lists and upload CSV files.

Include Student Names in Notifications

Enable student names in all Beacon email alert notifications.

Getting Started

Admin

Beacon

Discover

Hall Pass

Org Management

Parent

Teacher

Format and Upload an Escalation List CSV

Review CSV Requirements

Understand Scheduling Notes

Upload the CSV

Upload Status States

Download CSV Templates

Resources

Escalation Lists

Add and Manage Beacon Users

Beacon User Roles and Permissions

Include Student Names in Notifications

​Review CSV Requirements

​Understand Scheduling Notes

​Upload the CSV

​Upload Status States

​Download CSV Templates

​Resources

Escalation Lists

Add and Manage Beacon Users

Beacon User Roles and Permissions

Include Student Names in Notifications

Review CSV Requirements

Understand Scheduling Notes

Upload the CSV

Upload Status States

Download CSV Templates

Resources