> For the complete documentation index, see [llms.txt](https://docs.globalalerting.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globalalerting.com/administration/rules-engine/alert-rules-reference.md).

# Alert Rules Reference

## Conditions

### Alert Property

| Property                                        | Operators                                                                                                                                                            | Notes                                                                                                 |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| Of Any Name                                     | <p>Contains                                                                                                                                                          |                                                                                                       |
| <br>Does Not Contain                            |                                                                                                                                                                      |                                                                                                       |
| <br>Is Equal To<br>Is Empty<br>Is Not Empty</p> | Performs a text match against all property values for an alert.                                                                                                      |                                                                                                       |
| Title                                           | <p>Contains                                                                                                                                                          |                                                                                                       |
| <br>Does Not Contain                            |                                                                                                                                                                      |                                                                                                       |
| <br>Is Equal To<br>Is Empty<br>Is Not Empty</p> | Performs a text match against the alert title.                                                                                                                       |                                                                                                       |
| Text                                            | <p>Contains                                                                                                                                                          |                                                                                                       |
| <br>Does Not Contain                            |                                                                                                                                                                      |                                                                                                       |
| <br>Is Equal To<br>Is Empty<br>Is Not Empty</p> | Performs a text match against the alert text (body).                                                                                                                 |                                                                                                       |
| Description                                     | <p>Contains                                                                                                                                                          |                                                                                                       |
| <br>Does Not Contain                            |                                                                                                                                                                      |                                                                                                       |
| <br>Is Equal To<br>Is Empty<br>Is Not Empty</p> | Performs a text match against the alert description.                                                                                                                 |                                                                                                       |
| Approved                                        | <p>Is Equal To<br>Is Not<br>Is Empty</p>                                                                                                                             | Checks the approval state of the alert.  Possible values are "approved", "declined" or "no decision". |
| Source                                          | <p>Contains                                                                                                                                                          |                                                                                                       |
| <br>Does Not Contain                            |                                                                                                                                                                      |                                                                                                       |
| <br>Is Equal To<br>Is Empty<br>Is Not Empty</p> | Performs a text match against the alert source.                                                                                                                      |                                                                                                       |
| Risk Level                                      | <p>Is<br>Is Not<br>Is Greater Than<br>Is Greater Than Or Equal To<br>Is Less Than<br>Is Less Than Or Equal To</p>                                                    | Checks the risk level of an alert.                                                                    |
| Region                                          | <p>Contains                                                                                                                                                          |                                                                                                       |
| <br>Does Not Contain                            |                                                                                                                                                                      |                                                                                                       |
| <br>Is Equal To<br>Is Empty<br>Is Not Empty</p> | Performs a text match against the [name of the country](/administration/gap-for-travel-country-reference.md#full-country-names-list) in which the alert occurred.    |                                                                                                       |
| Country Code                                    | <p>Contains                                                                                                                                                          |                                                                                                       |
| <br>Does Not Contain                            |                                                                                                                                                                      |                                                                                                       |
| <br>Is Equal To<br>Is Empty<br>Is Not Empty</p> | Performs a text match against the [ISO-3166 country code](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) for the country in which the alert occurred. |                                                                                                       |
| Countrywide                                     | -                                                                                                                                                                    | Checks if the alert applies to an entire country (applies to Riskline alerts only).                   |

### Alert Location

| Property                  | Operators                           | Notes                                                                                  |
| ------------------------- | ----------------------------------- | -------------------------------------------------------------------------------------- |
| Address                   | <p>Contains<br>Does Not Contain</p> | Checks the reverse geocoded address (as provided by Google) and performs a text match. |
| Inside Any Geofence       | -                                   | Checks if the alert falls within any geofence in the same tenant as the rule.          |
| Inside Selected Geofences | GAP Geofence(s)                     | Checks if the alert falls within a specific geofence.                                  |

### Assets In The Event Location

| Property                     | Operators                                                                                                                                    | Notes |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
| Assets In The Event Location | <p>Travellers, Devices or Facilities Within:</p><p></p><p>10KM<br>20KM<br>50KM<br>100KM<br><br>Travellers Or Devices In The Same Country</p> |       |

## Actions

| Action                            | Parameters                                                                                                   | Notes                                                                                                                                                         |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Approve Alert                     | -                                                                                                            | Sets the alert status to approved.                                                                                                                            |
| Set Alert Icon                    | Icon ID                                                                                                      | Sets the alert icon to icon specified in the text box. Please contact the Support Desk for more information.                                                  |
| Notify Of Assets In Area          | E-Mail Addresses                                                                                             |                                                                                                                                                               |
| Send Email                        | <p>All Users<br>To Specified Recipients<br>To Travellers<br>To Travellers' Managers<br>To Facility Users</p> | Sends an e-mail to the specified recipients.                                                                                                                  |
| Send SMS                          | <p>All Users<br>To Specified Recipients<br>To Travellers<br>To Travellers' Managers<br>To Facility Users</p> | Sends an SMS to the specified recipients.                                                                                                                     |
| Call                              | <p>All Users<br>To Specified Recipients<br>To Travellers<br>To Travellers' Managers<br>To Facility Users</p> | Calls the specified recipients.                                                                                                                               |
| Notify Devices                    | Send Notification                                                                                            | Sends a text message to all devices within the specified radius or same country as the alert.                                                                 |
|                                   | Request Check-In                                                                                             | Sends a check-in request to all devices within the specified radius or same country as the alert, with the specified behaviour if the user does not check-in. |
| Send Message To Distribution List | GAP Distribution List                                                                                        | Sends message to all e-mail recipients in the distribution list.                                                                                              |
| Send Actions Summary              | E-Mail Address                                                                                               | Send an e-mail to the specified address detailing the actions taken by the rule. This e-mail is sent every time the rule is run and its conditions are met.   |