Digital wallet passes have become a ubiquitous tool for businesses, offering convenience and a streamlined user experience for customers. Ensuring your pass displays correctly requires an understanding of the specific image size requirements for Apple Wallet and Google Wallet.

The digital design that houses all the information and visuals for your pass.

Each individual image used within the pass template.

When discussing image size in the context of pixels, we're essentially talking about the resolution of the image. This refers to the number of pixels that make up the image's width and height.

Pixel Dimensions is the most common way to describe image size. It's expressed as two numbers separated by an "x," representing the width and height in pixels.

This is the ratio of the image's width to its height. It's often expressed as a simple fraction, such as 4:3 or 16:9.

Design applications like Adobe, Pixlr and Canva are software applications used for creating and editing various types of visual content.

Apple and Google controls the size and location of images on passes. The pass layout allots a certain area on the front of the pass for each image. Images are scaled (preserving aspect ratio) to fill this allotted space. Images with a different aspect ratio than their allotted space are cropped after being scaled.

Use high-resolution images to ensure they appear crisp and clear on various devices. Avoid blurry or pixelated images.

Recommended for transparency, especially if you want the logo to stand out against different background colors.

Can also be used, but PNG is generally preferred for better image quality.

People can receive passes via email or a webpage. To make downloads as fast as possible, use the smallest image files that still look great. There is no need to make images bigger than the dimension list below as this will not improve the sharpness / clarity. The sizes are the maximum and anything above this image size will increase the pass bundle size, which in turn will make it slower for a pass to be displayed on installed and take up more memory on the phone

Ensure your images use the correct color profile (e.g., sRGB) to avoid color discrepancies.

Consider accessibility guidelines, such as providing sufficient color contrast.

Prior to uploading your images to PassKit, use tools like Adobe Photoshop, Illustrator or Canva to create and optimize your images.

Reduce file size without compromising quality using tools like TinyPNG or Squoosh.

Small or improperly sized images may appear blurry, pixelated, or distorted on the wallet pass.

When uploading an image to the PassKit Pass Designer, you'll be prompted to crop it to the correct aspect ratio. However, it's best to create and optimize the image using the exact dimensions in a reliable design tool.

If using the PassKit API to upload an image, ensure your images have the precise aspect ratio to avoid errors. Images uploaded via the api can be urls or base64. URLs must be public links

Test your Wallet Passes on different devices and operating systems to ensure they display correctly.

The icon image is a mandatory image for all pass types. It is exclusively used by Apple Wallet. The dimensions are 87x87 and is prominently displayed in the the following places:

When you change the icon, Apple usually doesn't immediately update the cached icon. Instead, it waits for a suitable opportunity to refresh the cache. See Caching Notes section below for more details.

The logo image is a crucial element of a Wallet Pass, as it represents your brand or organization. It should be clear, recognizable, and visually appealing.

Dimensions depend on the platform and logo shape.

The Google Wallet Square Logo is required even if a rectangular one is uploaded.

Consider the logo's appearance on different background colors. To ensure optimal display, use a logo image with a transparent background. This allows the background color of the pass to shine through, enhancing the overall look.

If you're unsure about the best color combination, experiment with versions of your logo on different background colors in a design application.

Pass Type: Optional Image for all Membership Cards

The profile image, also known as the thumbnail image, is typically a photo of the pass holder but can be used for other images. This image is often used for identification purposes.

Pass Type: Optional Image for Loyalty Cards

The hero image, also known as the strip image, is a prominent visual element in both Apple and Google Wallet Passes. It's a large, high-quality image that occupies a significant portion of the pass's front face.

The hero image should be visually appealing and relevant to the pass's purpose. It can include:

You can use transparent images to achieve a layered effect on your Wallet Pass, allowing the background pass color to shine through certain sections. This can add depth and visual interest to your pass design.

Apple caches the Wallet icon to improve performance and efficiency. When you change the icon of a Wallet pass, the cached icon may not immediately reflect the change.

Here's how it typically works:

If these steps don't work, try restarting your device. This will usually clear the cache and force the system to reload the updated icon.