Skip to content

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
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, 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 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.

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.

Still stuck?

Our team answers every message. Contact support