Triggers Tutorial

Set Triggers to make pass-relevant text appear on a user’s lock screen based on location and/or date. Learn more in the Triggers Menu Guide, and read about additional Pass Distribution Methods.

See Pass Reference: Location Triggers for available triggers per pass type, requirements, and location radius and date window information.

What You'll Do

In this tutorial, you will:

  1. Open your project.
  2. Navigate to the Triggers menu.
  3. Select a template.
  4. Enter location, date/time, or beacon information.
  5. Save the new trigger.

Features and options are explained along the way.

Steps

Open your project from the dashboard, then click Triggers.


Click anywhere in a template's row to see its Trigger settings in the expanded view, and click again to hide. If you have only one template in the project, the initial view is expanded.

Relevant Location

You may add up to ten Relevant Locations per template.

  1. Click the Add Triggers button, then the Add a Relevant Location button. To remove an existing trigger, click the X in the upper right corner of its pane.
  2. Enter an address in the Address field, 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.

  3. Optionally enter the Relevant Text that will appear on the lock screen when a passholder is near the Location, e.g., "Store nearby on 3rd and Main."
    Note

    For Google passes, the Relevant Text is determined by Google, so it is not editable.

    If you would like to set multiple Locations, click the Add Another Location button and continue with your specifications. To remove an existing Location, click the X in the upper right corner of its pane.

  4. Click the Save Changes button, or Cancel to discard.

Relevant Date/Time

  1. Click the Add Triggers button, then the Add a Relevant Time button.
  2. Click the Select a day field and either use the date picker, or enter a date in MM/DD/YYYY format.

  3. Click the Select a time field and either select a time from dropdown menu, or enter a time in 24-hour notation, e.g., 16:47 for 4:47 p.m.

  4. Use the dropdown menu to Select a time zone.

  5. Click the Save Changes button, or Cancel to discard.

Beacons

Apple Wallet supports the addition of up to ten Beacons per template. For information about implementing Beacons, please see our iBeacons guide.

  1. Click the Add Triggers button, then the Add a Beacon button.
  2. Enter the Beacon's UUID

  3. Optionally enter the Beacon's Major and Minor values, if any.

  4. Enter the Relevant Text that will appear on the lock screen when a passholder is near the Beacon.

    If you would like to set multiple Beacons, click the Add Another Beacon button and continue with your specifications. To remove an existing Beacon, click the X in the upper right corner of its pane.

  5. Click the Save Changes button, or Cancel to discard.

Tutorials