Templates
Find, open, duplicate and delete pass templates, and see what each tab of a template holds.
A template is the design and the rules that every pass of one kind shares. Harbour Coffee's Coffee Card is one template; each customer's card is a pass issued from it. When you change a template, every pass issued from it follows.
Every planBefore you start#
- You need a Walletap account. If you are a team member, duplicating a template also needs permission to create templates — the account owner sets this in Team members.
The Templates page#
Go to Templates. Every template in the account is a card in the grid, fifteen to a page.

Each card shows the template drawn as its pass, then its name, its type and its status. A template is live from the moment it is created; there is no separate publish step.
Type in Search templates... to find a template by name. The count beside the search box is the number of templates in the account.
Template types#
The type decides which wallet layout the pass uses and which built-in fields it offers. You choose it when you create the template.
| Type | Use it for | Apple Wallet draws it as |
|---|---|---|
| Generic | Membership and ID cards | Generic pass |
| Loyalty | Points and stamp cards | Store card |
| Gift | A card that carries a remaining balance | Store card |
| Event | Tickets with a date, venue and seat | Event ticket |
| Coupon / Offer | A headline discount or offer | Coupon |
Pass types explains how to pick one.
Open a template#
Click a template card. It opens on the Design tab. The header shows Templates / Coffee Card; click Templates to go back to the list.
| Tab | What it holds |
|---|---|
| Design | How the pass looks |
| Rewards | Loyalty cards only: points or stamps, earning and rewards — see Set up rewards |
| Event | Event tickets only: the dates, venue and fine print |
| Sign-up | The sign-up link and QR code, the sign-up form and the Add to Wallet page — see Sign-up form and QR code |
| Members | Everyone holding a pass from this template — see Members |
| Messages | Campaigns, a loyalty card's automations, and the places and beacons that bring the pass onto the lock screen — see Campaigns |
| Settings | The template ID, languages, scanning and access, and Duplicate template and Delete template |
The Design tab#
The Design tab has three columns: a list of sections on the left, the section you are editing in the middle, and a live preview of the pass on the right. The sections scroll as one page, so clicking a section in the list jumps to it.

| Section | What it controls |
|---|---|
| Pass text | The name on the pass and, except on Generic templates, the issuer name |
| Colours | Background, label and text colours — see Artwork and colours |
| Images | Logo, icon, banners, poster artwork and a stamp card's stamp — see Artwork and colours |
| Front | The headline, top row and row — see Fields |
| Back | Fields, links and contact details on the back — see Fields |
| Buttons | Up to two buttons Apple Wallet shows beneath the pass, and your website or app as a button on Google Wallet |
| Google Wallet | The security animation and the tiles Google Wallet shows on a pass — see Fields |
Above the preview, switch between Apple and Google to see each wallet's version. On Generic, Loyalty, Gift and Coupon templates you can also switch the preview between Poster and Classic — that choice is part of the design and is saved with it. Fields explains the poster.
Template name and pass title#
These are two different things:
- The template name — Coffee Card — is how the template is listed in the dashboard and the apps. Holders see it too: it names the pass in the email and text messages that deliver it.
- The pass title is Name on pass, in the Design tab's Pass text section. It starts as the template name, and it is what the pass shows beside a square logo.
Save your changes#
One Save covers every tab. While a change is unsaved, the header shows Unsaved changes, Discard and Save. Discard goes back to what was last saved. Leaving the template with unsaved changes asks Discard changes? first. Members and campaigns are the exception: they save as soon as you create or change them.
Nothing reaches a holder until you save. Passes already in Apple Wallet then refresh with the new design. Passes in Google Wallet pick up some changes straight away; others, such as the background colour and the barcode, reach each pass the next time that pass is updated.
Settings#
The template's Settings tab holds:
- General — the template's Name and Template ID, the identifier the API uses for this template.
- Languages — the languages the pass is shown in. See Fields.
- Scanning — the barcode, and NFC on templates that have it. See Barcodes and NFC.
- Access — Unlock to view and Sharing. Both are set when the template is created and stay fixed.
- Duplicate template and Delete template — see below.
Duplicate a template#
A copy is the quickest way to start a second card that should look like the first — a Summer Jazz Night ticket for next season, or a membership for a second gym.
- Choose Duplicate
On Templates, click the … button at the top right of the card and choose Duplicate. Or open the template's Settings tab and click Duplicate template.
- Name the copy
The name starts as the original's with (copy) added. Give it the name you want it listed under — for example Summer Jazz Night 2027.
- Create the copy
Click Duplicate. The copy opens on its own Design tab.
The copy starts with the original's pass design and artwork, sign-up form, Add to Wallet page, languages, beacons and lock-screen locations — the locations up to what your plan allows. Members, campaigns and membership plans stay with the original, and a custom domain is not carried over. A copy is a new template, so it counts towards your template allowance.
Delete a template#
- Open Settings
Open the template and go to its Settings tab.
- Delete it
Click Delete template, then Delete to confirm. You return to the dashboard.
Every pass reads its design from its template each time it is opened or updated. So Walletap deletes a template only while no passes have been issued from it. If passes exist, the delete is refused with a message that says how many there are.
Deleting a template that has issued passes breaks those passes for the people who installed them: they can no longer be updated or reissued. If you must remove one anyway, the templates API can force the deletion.
If something goes wrong#
"This template has N issued passes…" — the template still has passes, so it was not deleted. See Delete a template.
Duplicate shows a lock, or the copy is refused with Upgrade — the account already holds every template its plan includes. Upgrade, or delete a template you no longer use.
"The template was duplicated but could not be opened." — the copy was made. Find it on Templates rather than duplicating again.
"You need to enter issuer name!" when saving — fill in Issuer Name under Pass text on the Design tab.
"You need to enter card name!" when saving — Name on pass, under Pass text on the Design tab, is empty.