# Google Wallet passes

> What your loyalty card looks like in Google Wallet's 2026 design and the classic one, the Google-only settings, Google's guidelines, and how passes update.

On Android, your card is a Google Wallet pass. Most of it comes from the **Design**, **Stamps** and **Details** tabs. The **Google Wallet** tab in the card editor adds two settings only Google uses, **Hero image** and **Logo style**, and checks your card against Google's guidelines as you design.

The one thing to know: in 2026 Google redesigned its passes. The hero image, where your stamps are drawn, used to be a thin strip. It is now a large, nearly square picture, so a wide banner no longer fits it well.

## The two designs

Google is moving phones to the new design in stages, so your customers will see one of two layouts for the same pass. You don't choose between them. The **Wallet preview** shows both: click **Google**, then **New design** or **Classic**.

| | **New design** | **Classic** |
| --- | --- | --- |
| Background | Your **Card color** fills the whole screen | Your card colour fills a card on a grey page |
| Logo and name | Round logo in the middle, your store name under it, then your **Card header** in large bold text | Small round logo and store name in a row, then your **Card header** |
| Hero image | Full width under the fields, nearly square | Full width at the bottom of the card |
| Details and links | In tinted blocks under the hero image | In a list under the card |

The preview shows the front of the pass. Click **Details** to see what Google lists under it (the customer's name, your text sections and your links), and **Front** to go back.

## What Google Wallet shows

| On the pass | Comes from |
| --- | --- |
| Logo | Your **Square icon** in a circle, or your **Logo** if there's no square icon. See [Logo style](#logo-style) |
| Store name | Your store name, under the round logo |
| Title | Your **Card header**, or your store name if the header is empty |
| Background colour | Your **Card color** |
| QR code | For your team to scan, with the card code underneath |
| **Stamps** | The customer's stamps, up to **Stamps required** |
| **Next reward** | Stamps left until the card is full, as a number, if **Next reward** is on |
| Your own front fields | On a second row under the stamp counts, and again in the details below |
| Hero image | Your **Hero image**, or your stamp strip background, with the stamps drawn on it |
| Customer's name | Listed under the card. The **Member** setting doesn't apply to Google |
| Text sections | **Next reward**, **Latest update**, your own front fields and **Invite a friend** |
| Links | Your [buttons](https://docs.getleal.com/cards/card-details#buttons), the customer's invite link (with referrals on) and "Powered by Leal" |

Google picks its own text colour, black or white, to suit your card colour. Your **Text color** setting only affects Apple Wallet.

## Hero image

**Hero image** is an optional picture for the large image on the pass. Your stamps are drawn on top of it.

- Use an image 1032 by 812 pixels, or larger in the same nearly square shape. A different shape is cropped from the centre to fit.
- Don't put text in it. Google asks for this, and text would sit under your stamps anyway.
- PNG, JPEG, GIF and WebP all work.

Without a hero image, the hero uses your stamp strip background from the **Design** tab, at the **Opacity** you set there. A **Color** or **Preset** background fills the hero well. An uploaded strip **Image** is wide, so only its middle shows. If you use one, upload a hero image too.

The stamps use the same rows as on Apple Wallet: one row for up to 5 stamps, two for 6 to 10, three for 11 to 21. They sit as a band across the middle of the image, so on a photo the top and bottom stay clear.

## Logo style

| Option | What Google shows | Good for |
| --- | --- | --- |
| **Round logo** | Your square icon in a circle, with your store name | Most stores. Upload a **Square icon** on the **Design** tab |
| **Wide logo** | Your **Logo** in place of the circle and store name | Logos that are a word or a wide shape |

With **Round logo** and no square icon, Leal shrinks your logo to fit inside the circle, so it looks small. Add a square icon or switch to **Wide logo**.

## Google's guidelines

The **Google Wallet** tab lists checks under **Google's guidelines**. Each shows a green tick or an amber warning, and updates as you change the card. A warning never stops you saving. It tells you the pass will look worse than it could.

| Check | What it looks for |
| --- | --- |
| **Card color** | Very bright, fully saturated colours, which are hard to read when they fill the screen |
| **Card header** | More than 46 characters |
| **Store name** | More than 20 characters |
| **Detail labels** | A label on your own front fields longer than 19 characters |
| **Detail values** | A value on your own front fields longer than 14 characters |
| **Logo** | No square icon while **Round logo** is selected |
| **Hero image** | A wide strip image standing in for the hero image |

## How Google Wallet passes update

When stamps change, when you send a [notification](https://docs.getleal.com/notifications) or when you edit the card, Leal updates the customer's pass on Google's side. The hero image, counts, fields, invite and QR code update on each customer's pass. Changes to the card's colour, header, logos, **Logo style**, front fields and buttons are sent to Google for everyone who holds the card.

## Expired cards

If a customer card expires, for example when you archive a card with an expiry date, Google Wallet shows the pass as expired. If the card has an **Expiry date (optional)**, Leal gives Google that date too, so the pass knows when it ends. See [Archiving a card](https://docs.getleal.com/cards/archiving-a-card).

## Best practices

- **Upload a hero image.** It is the biggest thing on the pass after your colour. A bright photo of your product or your shop works well.
- **Upload a square icon.** It fills Google's round logo properly.
- **Keep the card header short.** It is shown large and bold. Long headers shrink, wrap and may be cut off.
- **Check both designs.** Look at **New design** and **Classic** in the preview before you save, and click **Details** to check your links.
- **Test on an Android phone.** The preview is close, but nothing beats seeing the real pass.

## Gotchas

- **You can't pick the design.** Google decides which phones have the new design. A customer can also switch back to the old look inside Google Wallet.
- **Store changes need a card save.** If you change your store name or store logo in your store settings, passes already in Google Wallet keep the old one until you next save a change to the card's colour, header, logos, **Logo style**, front fields or buttons.
- **Next reward is a number.** Google shows the stamps left as "7", not "7 stamps", on the front of the pass.
