Image sizes reference
You can upload larger images than specified here. Keep the same aspect ratio for ideal results. Where a fixed aspect ratio applies, the crop tool enforces it after upload. If a crop doesn't match, the editor shows Invalid cropped image size. Transparent PNG files work as well.
Recommended sizes at a glance
| Image slot | Recommended size in px | Notes |
|---|---|---|
| Icon | 720 × 720 | 1:1 ratio, mandatory for every template |
| Logo | 960 × 150 | Upper left area of the pass |
| Google Wallet Logo | 660 × 660 | 1:1 ratio, only when you have enabled Google Wallet |
| Thumbnail | 540 × 1080 | Generic and event ticket background variant |
| Background for Store Card and Coupon | 1860 × 738 | Upper area of the pass |
| Background for Event Ticket | 1920 × 504 | Small background strip |
| Background for Event Ticket background variant | 1080 × 1320 | Full screen with an automatic blur |
| Android Background Image | 1032 × 336 | Optional separate background for Android wallet apps |
| Artwork | 1074 × 1344 | Enhanced poster layouts only |
| Primary Logo | 378 × 90 | Enhanced poster layouts only |
| Secondary Logo | 405 × 36 | Poster event ticket only |
| Venue Map | 1074 × 1074 | 1:1 ratio, poster event ticket only |
Where each image appears
Icon
The lock screen and the notification center show the icon in push notifications, and so do email attachments. Every template needs an icon, and it must be square with a 1:1 ratio.
Logo
The pass shows the logo in its upper left section. If you upload a wider logo, the pass still shows it, but the text fields to its right can end up cropped or hidden. You can hide the logo entirely, replace it per pass with Different for each Pass, or localize it per language.
Google Wallet Logo
Google Wallet uses a square logo. This slot appears only when you have enabled Google Wallet for the template. In that case the logo is mandatory unless you hide it.
Background
Coupons, store cards and event tickets have a background slot.
- Store Card and Coupon. The upper area of the pass shows it, 1860 × 738.
- Event Ticket. A smaller background strip in the upper section, 1920 × 504.
- Event Ticket background variant. Full screen with an automatic gaussian blur effect, 1080 × 1320.
You can provide a separate Android Background Image of 1032 × 336 for Android wallet apps.
Thumbnail
The right section of the pass shows the thumbnail, often a photo of the card holder. The Generic pass type and the event ticket background variant offer it. Like the logo and background, you can hide it, set it per pass, or localize it.
Image slots per pass type
| Pass type | Available slots |
|---|---|
| Coupon, Store Card and Event Ticket | Icon, Background, Logo, Google Wallet Logo, Android Background Image |
| Event Ticket background variant | Icon, Background, Thumbnail, Logo, Google Wallet Logo, Android Background Image |
| Generic | Icon, Thumbnail, Logo, Google Wallet Logo, Android Background Image |
| Boarding Pass | Icon, Logo, Google Wallet Logo |
Enhanced poster layouts
Templates with an enhanced pass type get an additional Enhanced Layout tab in the Images section.
- Poster event ticket. Artwork at 1074 × 1344, Primary Logo at 378 × 90, Secondary Logo at 405 × 36 and Venue Map at 1074 × 1074.
- Poster generic. Artwork at 1074 × 1344 and Primary Logo at 378 × 90.
See Overview of the template editor for what the enhanced layouts offer.
Next step
Continue withColors, images and linksChecked 2026-08-20 · Documentation
