# Designing your card

> Choose the header, logo, square icon, colours, strip background and stamp icon, and get a pass that looks sharp in Apple and Google Wallet.

Your card's look comes from two tabs in the card editor: **Design** for branding and background, and **Stamps** for the stamp icon and its colours. Everything here applies to both Apple Wallet and Google Wallet. The preview on the right updates as you change things. Each wallet also has a tab of its own for what only it shows: see [Apple Wallet passes](https://docs.getleal.com/cards/wallet-passes/apple-wallet) and [Google Wallet passes](https://docs.getleal.com/cards/wallet-passes/google-wallet).

The one thing to get right: **contrast**. Your text colour must be easy to read on your card colour, and your stamps must stand out from the strip behind them.

## Design tab

### Card header

**Card header** is the text next to your logo at the top of the pass. It starts as your store name.

- If your logo already spells out your name, you can clear this field. On Apple Wallet the logo then sits on its own.
- Google Wallet always shows a title, in large bold text. If the header is empty, it uses your store name. Keep it to 46 characters or fewer, and shorter is better.

### Logo

**Logo** is the wide logo at the top of the pass. Leave it empty to use your store logo. A card can't be saved with no logo at all, so if your store has no logo, upload one here.

- Use a PNG with a transparent background. JPEG, GIF and WebP also work.
- Apple Wallet fits the logo inside a space up to 160 by 50 points, so a wide, short logo works best. A tall square logo will look small.
- On the iOS 27 poster style, the logo space is smaller still (up to 126 by 30 points).

### Square icon

**Square icon** is used as the small wallet icon on iOS and as the round logo on Google Wallet. It should be square. Leave it empty to use your store icon.

Google shows it in a circle, so keep anything important away from the corners. An icon of 660 by 660 pixels or more stays sharp. If there's no square icon anywhere, Leal shrinks your wide logo to fit inside the circle, which looks small, so it's worth uploading one. If your logo is a word, you can show it wide on Google instead: see [Logo style](https://docs.getleal.com/cards/wallet-passes/google-wallet#logo-style).

### Card color and Text color

**Card color** fills the pass. **Text color** is used for the labels and values on it, such as **Stamps** and **Next reward**. Pick a dark card with white text, or a light card with dark text. Mid tones (a medium grey or a pastel) make text hard to read in bright light.

Google Wallet fills the whole screen with your card colour and chooses the text colour itself, black or white. **Text color** applies to Apple Wallet only. Avoid very bright, fully saturated colours (a neon green, say): Google asks stores not to use them, because text is hard to read on a screen full of them.

### Stamp strip background

The strip is the band behind the stamps on a store card pass. It's also what fills Google Wallet's hero image if you don't upload a **Hero image**, and the background of an Apple poster pass if you don't upload poster artwork. Under **Background type**, pick one:

| Option | What it is | Good for |
| --- | --- | --- |
| **Color** | A flat **Strip color** | The cleanest look, and the easiest to keep readable |
| **Image** | Your own photo or graphic | Showing your shop, product or pattern |
| **Preset** | One of ten built-in photos (coffee beans, a coffee cup, bakery, pizza, sushi, burger, ice cream, smoothie, flowers, spa) | A quick photo look without your own image |

For **Upload image**, the recommended size is 750 by 288 pixels, or larger at the same 2.6 to 1 shape. A different shape is cropped from the centre to fill the strip, so keep anything important away from the edges. Google Wallet's hero image is nearly square, so it shows only the middle of a wide strip image. Upload a **Hero image** on the **Google Wallet** tab to choose what Google shows.

**Opacity** (0 to 100%, in steps of 5) sets how strongly the strip shows. At 100% you see exactly the colour or image you chose. Lower values let your card colour show through it. Turning a busy photo down to 40 to 60% is a simple way to keep the stamps readable on top of it.

## Stamps tab

### Stamp icon

Pick one of 18 built-in icons (a star, heart, coffee cup, coffee bean, pint glass, cake, barbell, tick, spray bottle, shopping trolley, diamond, high heel, hairdryer, paw print, scissors, sun, flower and coat hanger), or choose **Custom icon** and upload your own.

- A custom icon can be PNG, JPEG, GIF, WebP or SVG. A simple shape on a transparent background works far better than a detailed logo, because each stamp is small.
- If you remove a custom icon, the card goes back to the star.

### Stamp color and Stamp background

**Stamp color** is the colour of a collected stamp. **Stamp background** is the circle each stamp sits in. Pick colours that are clearly different from each other and from the strip, so a customer can see at a glance how many they have.

### How the stamps are laid out

Leal arranges the stamps automatically based on **Stamps required**, the same way on both wallets:

| Stamps required | Rows |
| --- | --- |
| 1 to 5 | 1 |
| 6 to 10 | 2 |
| 11 to 21 | 3 |

On Google Wallet the rows sit across the middle of the nearly square hero image.

More stamps means smaller stamps. See [Stamps required and initial stamps](https://docs.getleal.com/cards/stamps) for choosing a number.

## Best practices

- Check the preview in both **iOS** and **Google** before you save. They don't look identical. See [Wallet passes](https://docs.getleal.com/cards/wallet-passes).
- Keep the strip simple. A flat colour, or a photo at reduced opacity, keeps the stamps easy to count.
- Use a transparent PNG logo. A white box around your logo on a coloured card looks unfinished.
- Upload a square icon, so Google Wallet and the iOS wallet icon don't fall back to your wide logo.
- Open the **Google Wallet** tab before you save and clear any warnings under **Google's guidelines**.

## Gotchas

- **Image changes take a moment.** After you save a design change, Leal redraws the stamp images in the background, then updates customers' passes. See [Editing a live card](https://docs.getleal.com/cards/editing-a-live-card).
- **Text color and strip.** Your text colour doesn't apply to the stamps. Stamps use **Stamp color** and **Stamp background** only.
- **Logo upload types.** Logos, square icons, strip images and the Google hero image accept PNG, JPEG, GIF and WebP. Only the custom stamp icon also accepts SVG.
