Add a hero image or thumbnail
Last updated: November 5, 2026
Hero and thumbnail image fields appear in the builder's Brand assets section only when your pass's layout uses one - a hero (wide banner) for event-ticket-style layouts, a thumbnail for membership-style layouts.
Separate images for Apple and Google
The hero layout has two fields: Apple Hero Image (Apple Wallet's strip, 375 × 98 points - about 4:1) and Google Hero Image (1032 × 336 pixels - about 3:1). Uploading either opens a crop frame in exactly that shape, so you can frame each one for its wallet and don't need to prepare the files yourself. Upload the largest version you have: at least 1125 pixels wide for Apple and 1032 pixels wide for Google keeps them sharp.
Thumbnail
The thumbnail layout has an Apple Thumbnail (square). Google Wallet has no thumbnail slot, so on Google that image is shown as the hero image instead.
Rectangle logo
The hero layout also has a Rectangle Logo: a wide wordmark, about 16:5 (1280 × 400 pixels is ideal). When it's set, Apple Wallet and Google Wallet both show it top-left in place of the logo and the logo text. Your Logo is still used for the pass's icon, such as on Apple Wallet's lock-screen notifications.
No image yet
Passes render cleanly with no hero or thumbnail set - the layout just shows its text fields on the plain background color until you add one.
More in Design & Branding
- Make a poster passFill the whole pass with your artwork in Apple Wallet on iOS 27, with the classic layout on older iPhones and Google Wallet.
- Add a photo for each person (photo ID passes)Give everyone on a pass their own photo, for staff IDs and member cards: one at a time, many at once by file name, or from links in a CSV or the API.
- Add a blurred background image (Apple Wallet)Put a blurred image behind your whole Apple Wallet pass: pick one of 10 ready-made backgrounds or upload your own.
- Customize colors and your logoMatch a pass to your brand with background, text, and label colors.
- Choose a layoutBackground, hero image, or thumbnail - which layout fits your pass.
Was this article helpful?