Open dashboardwalletap.com

Templates

Find, open, duplicate and delete pass templates, and see what each tab of a template holds.

Web

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 plan

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

The Templates page with six template cards, each drawn as its pass: Coffee Card, Harbour Points, Northside Membership, Summer Jazz Night, Harbour Gift Card and Spring Offer

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.

TypeUse it forApple Wallet draws it as
GenericMembership and ID cardsGeneric pass
LoyaltyPoints and stamp cardsStore card
GiftA card that carries a remaining balanceStore card
EventTickets with a date, venue and seatEvent ticket
Coupon / OfferA headline discount or offerCoupon

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.

TabWhat it holds
DesignHow the pass looks
RewardsLoyalty cards only: points or stamps, earning and rewards — see Set up rewards
EventEvent tickets only: the dates, venue and fine print
Sign-upThe sign-up link and QR code, the sign-up form and the Add to Wallet page — see Sign-up form and QR code
MembersEveryone holding a pass from this template — see Members
MessagesCampaigns, a loyalty card's automations, and the places and beacons that bring the pass onto the lock screen — see Campaigns
SettingsThe 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.

The Design tab for Coffee Card: the section list on the left, the Images section in the middle and an Apple Wallet preview of the card on the right
SectionWhat it controls
Pass textThe name on the pass and, except on Generic templates, the issuer name
ColoursBackground, label and text colours — see Artwork and colours
ImagesLogo, icon, banners, poster artwork and a stamp card's stamp — see Artwork and colours
FrontThe headline, top row and row — see Fields
BackFields, links and contact details on the back — see Fields
ButtonsUp to two buttons Apple Wallet shows beneath the pass, and your website or app as a button on Google Wallet
Google WalletThe 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.

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

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

  3. 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#

  1. Open Settings

    Open the template and go to its Settings tab.

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

Warning

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.

Next steps#

Templates - Walletap Documentation