Skip to main content
A wallet pass has a fixed set of areas, each with its own job. Once you know them, every control in the template editor maps to a spot on the pass. The areas of a wallet pass: logo and header fields at the top, strip image with the primary field, secondary and auxiliary field rows, and the barcode at the bottom

​
The front of the pass

From top to bottom: Here is every area in place on a real pass, a store card open in Apple Wallet on an iPhone:
The front of a store card pass open in Apple Wallet on an iPhone, with the Hold Near Reader prompt below it

Logo and logo text top-left, a Member Tier header field top-right, the Balance primary field on the strip image, Member and Member Since on the shared field row, and the NFC tap icon bottom-right.

​
The back of the pass

Customers reach the back through the ⋯ button when the pass is open in their wallet. Back fields hold everything that doesn’t belong on the front: terms, contact details, longer descriptions, links. There’s much more room here, and text can be longer.
The back of a pass in Apple Wallet on an iPhone, showing wallet toggles followed by Terms & Conditions, Customer Support, and Serial Number back fields

The back of the same pass: your back fields (here Terms & Conditions and Customer Support) sit below the wallet's own controls, like automatic updates and notifications.

The toggles above your back fields belong to the wallet, not your template. Each customer controls them on their own device. Knowing what they do helps when a customer reports a pass that “isn’t working”:
The Serial Number on the back of the pass is the same value as the Pass ID on the pass detail page in the portal. A customer can read it to you to confirm you’re both looking at the same pass. See passes.
On iPhones running iOS 27 and later, Apple Wallet can show up to two action tiles directly below the pass. Each tile is a shortcut, like View Membership Benefits or Call, that opens a web page, starts a phone call, or shows a location in Apple Maps. Featured actions work on every pass style, not only the poster layouts. Set them up in the Actions section of the editor’s Advanced tab:
  1. Click Add action.
  2. Choose an Action type. The type decides the tile’s icon and text in the wallet, so you can’t write your own label.
  3. Enter what the action type needs: a phone number, coordinates, or a URL (see the table below).
What a tile needs, and what happens when a customer taps it, depends on the action type: The other types are View Schedule, Watch Trailer, Listen to Music, Add to Balance, Order Delivery or Pickup, Shop Online or In-App, View Membership Benefits, Book an Appointment, Book a Car, Book a Flight, Book a Stay, and View Offers and Rewards. The menu shows a category under each type, such as Membership or Events. It’s only a grouping: you can use any action type on any pass style. Good to know:
  • Only the first two actions show. You can add more, but the wallet ignores everything after the second. Use the arrows to move the two that matter most to the top.
  • Each action type can be used once per pass template.
  • Apple Wallet only. Google Wallet passes and iPhones on iOS 26 and earlier don’t show the tiles. The rest of the pass looks the same either way.
  • Check the preview. The editor preview shows the tiles below the pass. Click a tile to jump to its settings.
  • Actions for a single pass. An integration can give one pass its own actions through the Stell API. They replace the template’s actions for that pass, and the pass detail page lists them under Template Overrides.
The editor also offers footer fields. These only appear on the generic poster layout, as a final line at the very bottom of the pass. On other layouts, keep your content in the areas above.

​
Pass styles

The pass style (chosen in the Settings tab) decides the overall layout, most importantly which images the pass can show: The five pass styles: Store Card and Coupon use a strip image, Generic uses a thumbnail or a poster layout, Event Ticket uses a thumbnail or a poster layout, and Boarding Pass has no strip image Switching style keeps your fields and images but changes how they’re laid out. Check the preview after switching, since an image one style shows may not appear on another. A strip image won’t show on a Generic pass, for example.

​
Layout by style

Each style arranges the same areas differently. The two poster variants are the new, modern pass presentations: full-bleed artwork carries the design, and they activate automatically on newer iPhones when your template has poster artwork.
Store card layout: logo and header fields at the top, strip image with the primary field on it, secondary and auxiliary fields sharing one row, barcode at the bottomThe most common layout, and the one used by most loyalty programs. It has a strip image with the primary field on it, and secondary and auxiliary fields sharing one row: up to 4 fields in total, kept short so they fit. The Coupon style is laid out the same way; it reads as an offer, where a store card reads as a membership.

​
How this knowledge maps to the editor

  • The wallet draws the pass; you supply the ingredients. You can’t move the areas around; you decide what goes in each area.
  • Less is more: passes are glanced at, not read. A strong image, one primary value, and a couple of supporting fields beat a crowded layout.
  • Field values can be dynamic, showing each customer their own name, balance, or tier. See fields and dynamic content.
For design advice beyond the mechanics, read what makes a pass worth keeping on getstell.com.
Want to go deeper? Apple’s developer documentation covers the underlying pass format in technical detail. See Wallet Passes on the Apple Developer site. You won’t need it to use the editor; everything merchant-relevant is covered in these pages.