# Location-Based Pass Alerts

Set triggers to make pass-relevant text appear on a user's lock screen based on location, date, or proximity to a beacon.

* The user must have already installed the pass for the trigger to function.
* See [Mobile Wallet Reference: Location and Date Triggers](https://www.airship.com/docs/guides/wallet/user-guide/reference/#location-and-date-triggers) for available triggers per pass type, requirements, and location radius and date window information.
* For Apple specifications, see [Relevance Information Displays Passes on the Lock Screen](https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/PassKit_PG/Creating.html#//apple_ref/doc/uid/TP40012195-CH4-SW53), including Table 4-2, in
the Apple Wallet Developer Guide.
* For Google specifications, see [Nearby Notifications](https://developers.google.com/wallet/retail/loyalty-cards/use-cases/trigger-push-notifications#nearby-notifications) in the Google Wallet Developer Guide.

## Add a Relevant Location Trigger

Display a shortcut to your pass on the user's screen when the device is in the vicinity of a certain location. The radius around the location where the shortcut appears is determined by the wallet platform and varies by pass type. For instance, Boarding Passes will appear on the lock screen at around 1,000 m, while Coupons will appear at around 100 m. You can add up to ten Relevant Locations per template and per pass.

1. Go to **Triggers**.
1. Click anywhere in a template's row to see its trigger settings in the expanded view. If you have only one template in the project, the initial view is already expanded.
1. Click **Add Triggers** then **Add a Relevant Location**.
1. Enter an *Address*, then click to choose the
   address from the list of matches that appears. After selecting the address, its GPS coordinates will be listed next to the Location pane's title.
1. (Optional) Enter the *Relevant Text* that will appear on the lock screen when a pass holder is near the location. For example, "Store nearby on 3rd and Main." For Google passes, the *Relevant Text* field is determined by Google, so it is not editable.
1. (Optional) Click **Add Another Location** and continue with your specifications.
1. Click **Save Changes**.

Location triggers can be used in combination with [Date/Time Triggers](#add-a-relevant-date-time-trigger).

Alternatively, you can define up to 10,000 locations for passes installed from an [Adaptive Link](https://www.airship.com/docs/reference/glossary/#adaptive_link), which will detect the 10 locations nearest the user and associate them with the pass as the location triggers. See the locations array for an [Adaptive Link request](https://www.airship.com/docs/developer/rest-api/wallet/schemas/adaptive-links/#adaptivelinkrequest) in our Wallet API reference.

## Add a Relevant Date/Time Trigger

Display a shortcut to your pass on a user's lock screen when the device is in the vicinity of a certain location during a certain date and time. This is handy for certain types of passes that have date and time relevancy, like Events and Boarding Passes. 

   * Relevant Date/Time triggers are supported for Apple Wallet passes only.
   * The timing when the shortcut appears is determined by the wallet app and varies by pass type.
   * Relevant Date is not supported for Coupons or Store Cards.
   * You can use Date and Time without Location for Event passes only.


1. Follow the steps above to set up a [Relevant Location trigger](#add-a-relevant-location-trigger).
1. Go back to **Triggers**.
1. Click anywhere in a template's row to see its trigger settings in the expanded view. If you have only one template in the project, the initial view is already expanded.
1. Click **Add Triggers** then **Add a Relevant Time**.
1. Make selections for the *day*, *time*, and *time zone* when you want the pass to display.
   * **Select a day:** Use the date picker, or enter a date in MM/DD/YYYY format.
   * **Select a time:** Select a time from dropdown menu, or enter a time in 24-hour notation, e.g., 16:47 for 4:47 p.m.
   * **Select a time zone:** Select from the dropdown menu.
1. Click **Save Changes**.

## Add a Beacon Trigger

Display a lock screen notification with a shortcut to the pass when the device is within the proximity range of a certain [beacon](https://en.wikipedia.org/wiki/IBeacon). You can add up to ten beacons per template. Beacon triggers are supported for Apple Wallet passes only.


1. Go to **Triggers**.
1. Click anywhere in a template's row to see its trigger settings in the expanded view. If you have only one template in the project, the initial view is already expanded.
1. Click **Add Triggers** then **Add a Beacon**.
1. Enter the beacon's *UUID* and the *Relevant Text* that will appear on the lock screen when the
   pass holder is near the beacon.
1. (Optional) Enter the beacon's *Major* and *Minor* values.
1. (Optional) Click **Add Another Beacon** and continue with your specifications.
1. Click **Save Changes**.

## Edit or Remove a Trigger

1. Go to *Triggers*.
1. Click anywhere in a template's row to see its trigger settings in the expanded view. If you have only one template in the project, the initial view is already expanded.
1. Click a trigger to highlight it, then make your desired changes, or click the X in the upper right corner of its pane to delete it.
1. Click **Save Changes**.