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.

Was this article helpful?

Still need help?

Our team is here to answer your questions.

Contact us

Be on the lock screen in a few minutes.

Your first pass is quick to make. Pick a template, add your logo, and share the link.