Wallet Segments Builder Tutorial

Segments are reusable audience selection criteria. They are used with the Publish feature to apply template design changes to Apple Wallet passes that have already been distributed. Create a segment instead of recreating your audience selections every time you update a pass. Segments are created within a project and can be used for any Apple Wallet template within that project.

Learn more in Segments and Targeting Your Audience.


Segments can also be created via the API. See: Wallet API: Segments.

What You'll Do

In this tutorial, you will:

  1. Open your project.
  2. Navigate to the Segments menu.
  3. Select tags and conditions.
  4. Name the segment.
  5. Save the segment for use.

Features and options are explained along the way.


Open your project from the dashboard, then click Segments.

Create a New Segment


Tags are selected from — not created by — the Segments Builder. Select tags that you have already created and attached to passes. See the API: Tags documentation.

  1. Click the New Segment button to open the Segments Builder.
  2. Select whether the conditions you set will apply to All or Any passes in the project. The default statement is "Include passes where All of the following are true." Use the All/Any dropdown menu to change your selection.

    • All = all criteria must be met (Boolean AND)
    • Any = any criteria must be met (Boolean OR)
  3. Choose is or is not from the next dropdown menu.

  4. Enter your search term, and click to select from the listed search results, if any.

    If you would like to set multiple conditions, click the Add a condition button and continue with your specifications.

    To remove an additional condition, click the X at the end of its row.

  5. Enter a descriptive name.

  6. Click the Save button, or Exit to discard.

Click the Segments menu link to return to your list of segments.

Update a Segment's Passes

To update a segment's passes, use the Publish feature. When choosing which passes to update, select the radio button for A specific segment, then select your previously created segment. See: Publish Tutorial.

Edit or Delete a Segment

Open your mobile wallet project from the dashboard, then click Segments in the navigational header.

Three attributes are displayed per segment:

  • Segment Name
  • Date Created
  • Date Edited: The date and time when the list was last edited.

Click the trash can icon to delete the segment, or click the pencil icon to edit. Editing has the same as creating a new segment.