Wallet Pass Image Specifications

Daniel Baudino

Updated March 15, 2026

TL;DR: Reference specifications for Apple Wallet and Google Wallet pass images.
  • Apple: PNG only, provide highest resolution version
  • Google: PNG preferred, single high-resolution version
  • Google logo is auto-masked to circle — 15% safety margin required
  • Keep total pass size under 1-3 MB for fast downloads

Overview

This reference provides exact image specifications for Apple Wallet and Google Wallet passes. Use these specifications when creating assets. For design philosophy and strategy, see the platform guides.

Apple Wallet Image Specifications

File Format Requirements

RequirementSpecification
FormatPNG only (.png)
Color ProfilesRGB recommended
TransparencySupported

Icon Image (Recommended)

The icon appears on the lock screen and in system notifications.

ImageDimensions (px)
icon.png87 × 87

Supported by: All pass types

Logo Image

The logo appears in the header area of the pass.

ImageDimensions (px)
logo.png480 × 150 (max)

Supported by: All pass types

  • Logo can be rectangular or square
  • Images are scaled to fit, preserving aspect ratio
  • Logo should typically be narrower than maximum width

Strip Image

The strip is a full-width banner displayed on the pass front.

Pass TypeRecommended (px)
Event Ticket1125 × 294
Coupon / Gift Card1125 × 432
Loyalty1125 × 369

Supported by: Coupon, Event Ticket, Loyalty

  • Not displayed on Apple Watch
  • Recommended to provide 1125px wide version

Thumbnail Image

A small image displayed next to the fields on the pass front.

ImageDimensions (px)
thumbnail.png270 × 270 (max)

Supported by: Event Ticket, Access Control

  • Aspect ratio should be 2:3 to 3:2 (outside this range, image is cropped)
  • Not displayed on Apple Watch

Background Image

A blurred full-screen background behind the pass content.

ImageDimensions (px)
background.png540 × 660

Supported by: Event Ticket only

  • Image is cropped and heavily blurred
  • Can provide smaller size since blur hides details
  • Cannot be used with strip or thumbnail on Event Tickets

Pass Type Image Support Matrix

ImageCouponEvent TicketAccess ControlLoyalty
IconRecommendedRecommendedRecommendedRecommended
LogoYesYesYesYes
StripYesYes*NoYes
ThumbnailNoYes*YesNo
BackgroundNoYes*NoNo

*Event Ticket: If using strip image, do not use background or thumbnail.

Advanced Event Tickets

iOS 18 introduced poster-style event tickets with additional image requirements.

ImageDimensions (px)Notes
Artwork1074 × 1344Full canvas size
Primary LogoStandard logo specsHeader area
Secondary LogoOptionalAdditional branding

Layout considerations: - Top portion has black gradient overlay (system date/location) - Bottom 360px covered by seat information - Place critical branding in visible center area

Requirements: - NFC-enabled passes only - Enable "Advanced Event Ticket" in pass template settings - Backwards-compatible (older iOS shows standard layout)

Apple Wallet File Size Guidelines

MetricRecommendation
Individual imageUnder 200 KB
Total pass packageUnder 1 MB ideal, 3 MB maximum

Google Wallet Image Specifications

File Format Requirements

RequirementSpecification
FormatPNG preferred, JPG accepted
Color ProfilesRGB recommended

Logo Image (Required)

Google Wallet automatically masks logos into a circle.

SpecificationValue
Minimum Size660 × 660 px
Maximum Size840 × 840 px
Aspect Ratio1:1 (square)
Safety Margin15% from edges
BackgroundFull bleed color recommended

Critical: Keep all important content within the inner 70% circle. Google auto-crops to circle shape.

Google Wallet logo safety margin diagram

Hero Image

A full-width banner displayed across the pass body.

SpecificationValue
Recommended Size1032 × 336 px
Alternative Size1125 × 432 px (cross-platform)
Aspect Ratio3:1 or wider
Edge Buffer60px from edges for critical content

Image may be cropped or scaled depending on device. Avoid text in images. Design for proportional scaling.

Google Wallet hero image scaling behavior

Full-Width Module Image

Images displayed in the pass details section.

SpecificationValue
Minimum Width1860 px
HeightVariable (proportional)
BackgroundColored background recommended

Google Wallet Pass Type Image Support

ImageAccess ControlLoyaltyEvent TicketOffer
Logo (square)RequiredRequiredRequiredRequired
Wide LogoYesYesYesYes
Hero ImageYesYesYesYes
Full-widthYesYesYesYes
Barcode imagesYesYesYesYes

Cross-Platform Recommendations

When designing for both platforms simultaneously:

AssetApple WalletGoogle WalletCross-Platform
Logo480 × 150 px660 × 660 pxProvide both formats
Banner/Hero1125 × 432 px (strip)1032 × 336 pxUse 1125 × 432 px
Icon87 × 87 pxN/AApple only

Common Mistakes

Apple Wallet: - Using strip + background on Event Tickets (invalid combination) - Images with embedded text (doesn't scale)

Google Wallet: - Pre-masking logo to circle (Google does this automatically) - Critical content in outer 15% of logo (gets cropped) - Hosting images on HTTP instead of HTTPS - Text in hero images (inconsistent rendering)

Both Platforms: - Oversized images slowing downloads - Relying on images for essential information - Not testing on actual devices

Sources

Was this article helpful?
Yes No

More articles in Technical Reference

Color Specifications

This reference covers color configuration for Apple Wallet and Google Wallet passes. The platform...

Field Limits By Platform

This reference provides field limits and character constraints for Apple Wallet and Google Wallet...

Barcode And Nfc Reference

This reference covers barcode formats and NFC specifications for wallet passes. Both platforms su...