Guides

Pass Styles

In this page you'll learn about pass styles. The pass style sets the overall appearance and purpose of the pass. The most distinctive visual indication of the style is at the top edge of the pass. Event tickets have a small cutout, coupons have a perforated edge, etc.

The pass style controls how fields are laid out and which images can be used. They also control how relevance fields are used as described in Apple's guides located here.

Boarding passes

A boarding pass style is appropriate for passes used with transit systems such as train tickets, airline boarding passes, and other types of transit. Typically, each pass corresponds to a single trip with a specific starting and ending point. It supports a logo, icon and footer as well as two primary fields and optionally header, secondary, auxiliary and back fields:

Loyalty templates styles boarding pass 2991fcde5c

Coupons

This pass style is appropriate for coupons, special offers, and other discounts. It supports a logo, icon and strip as well as a primary field and optionally header, secondary, auxiliary and back fields:

Loyalty templates styles coupon 712be0f57d

Event Tickets

This pass style is appropriate for passes used to gain entry to an event like a concert, a movie, a play, or a sporting event. Typically, each pass corresponds to a specific event, but you can also use a single pass for several events as in a season ticket. It supports a logo, icon and a strip or a background and thumbnail. If you specify a strip image you should not specify a background image or a thumbnail. You can also include a primary field and optionally header, secondary, auxiliary and back fields:

Loyalty templates styles ticket 5adb3bb25b

Store Card

This pass style is appropriate for store loyalty cards, discount cards, points cards, and gift cards. Typically, a store identifies an account the user has with your company that can be used to make payments or receive discounts. When the account carries a balance, show the current balance on the pass. It supports a logo, icon and a strip as well as a primary field and optionally header, secondary, auxiliary and back fields:

Loyalty templates styles store card 5f4f5321eb

Generic

This pass style is appropriate for any pass that doesn’t fit into one of the other more specific styles—for example, gym membership cards, coat-check claim tickets, and metro passes that carry a balance. It supports a logo, icon and thumbnail. You can also include a primary field and optionally header, secondary, auxiliary and back fields:

Loyalty templates styles generic a23c3bd461

Designing for Apple Watch

Even if you’re not creating watch-specific passes, users can add any pass you create to their Apple Watch. So you need to understand how Apple Watch handles passes, in order to create passes that function properly on both iPhone and Apple Watch.

Here's how Apple Watch will present a coupon, event ticket, store card, or generic pass:

Loyalty templates styles watch all 9142cf545d

And below how the Apple Watch will show a boarding pass:

Loyalty templates styles watch boarding 527fe587ef