Customize a Wallet pass design

Use the Wallet pass editor to change the colors, images, and fields on the Apple Wallet passes issued for your KORONA Event tickets.

Create a design

1. Open Comms > Wallet passes and select Create.
2. Enter an Internal name.
3. Under Start from, choose Empty design for the Plain layout with no fields, or Copy of an existing design and choose the design in Design to copy. A copy includes the layout, colors, images, and fields; the original stays unchanged.
4. Select Create and open editor. Edit the design, then preview and save it before using it for new passes.

Creating a design keeps the existing default. If this is your account's first design, it becomes the default automatically.

Start with a safe copy

You need access to edit Wallet pass designs. Have your branding images and a representative ticket ready for the preview.

1. Open Comms > Wallet passes in the backoffice.
2. Find the design marked Default. This is the account fallback when no more specific design is assigned.
3. Select Duplicate from its row menu and confirm. The copy opens in the editor. If you already opened the default design, select Duplicate to try changes instead.
4. In Pass, enter an Internal name, such as “Museum admission — summer design”, and keep Use for new passes off while preparing it.

Duplicating copies the saved design. If you have unsaved changes, save them before duplicating if you want them in the copy. Editing and previewing a draft do not publish it; Save changes saves the design. Saving changes to the current default affects newly issued passes, so use a copy to prepare changes safely.

The Internal name identifies the design in the list and in an offer’s template selection. It is shared across content languages and is not shown on customers’ passes. Use the search field in Wallet passes to find a saved design by name.

Choose the appearance

In Pass, choose a Layout:

Set Text color, Label color, and Background color where available. With Background image, the text color is fixed to white. Primary text over a Banner image is also always white; other text can use your configured colors. Choose Plain for dark primary text.

Under Images, upload Logo, Icon, Strip image, or Background as needed. Slots unused by the selected layout are marked accordingly. Logo text appears beside the logo. Description titles the pass details and is read aloud by VoiceOver.

Arrange and edit fields

1. In Structure, select an existing field or use Add field to the desired area: Header, Primary, Secondary, Auxiliary, or Back of pass.
2. In Field, edit Label and Value. Type @ to open the editor's suggestions and insert available ticket placeholders or reusable text blocks.
3. Drag fields in Structure to reorder them or move them between areas. You can also change a field's Area in Field.
4. Use Show on pass to hide a field while retaining its settings. Set Show only if to a placeholder when the field should be omitted if that placeholder is empty; Always removes the condition.
5. Use Remove field to delete a field from the draft.

The front has limited space: up to three header fields, one primary field, four secondary fields, and four auxiliary fields. Long content can still be shortened or omitted. Move supporting information to Back of pass when it does not fit; watch for Not shown on iPhone and the preview warnings.

Show the ticket holder’s name

Collect the holder’s details with per-attendee First name and Last name questions as described in Sell personalized tickets. Collecting a name does not add a field to an Apple Wallet design automatically.

1. In Structure, add a field to Secondary, or select an existing field to replace.
2. In Field, choose Text as the Value type and enter a Label, such as Ticket holder.
3. In Value, type @ and choose Ticket holder full name. This inserts the holder placeholder; do not enter one person’s name as fixed text.
4. Choose a Sample ticket with holder details to see the field in the preview.

For personalized tickets, missing holder-name answers remain blank. Make the name questions required when each ticket must show its own holder. Use the Plain layout to show the holder’s photo alongside your background color.

Choose the content language and value type

Select Content language in the top bar to edit Label, Value, Logo text, and Description for that language. Empty translations fall back to your account's main language. This changes pass content, not the language of the backoffice controls.

In Value type, choose:

• Text for written content and placeholders.
• Date for Event start or Event end, with Date style and Time style. You can use relative wording such as Today or Tomorrow, or select Show the event's local time in every time zone when the event time must stay fixed.
• Number for a numeric value, with Number style and an optional Currency code, such as EUR. Leave the currency code empty for a plain number.

Dates and numbers are formatted by Wallet using the customer's phone language and time zone, subject to the date options you select. The preview cannot reproduce every customer's device settings.

Preview and test the draft

1. Choose a Sample ticket in the top bar to preview representative ticket content.
2. In Preview, switch Device and compare Front with Pass details.
3. Review Warnings for missing fields, shortened text, contrast, image quality, or device limits. Select a field warning to open that field, then shorten its content, move it, or adjust its appearance as needed.
4. Select Try on iPhone, then scan the QR code with your iPhone camera to add the current draft to Wallet. When working on the iPhone, use Open on this device.

The browser preview is an approximation. Apple Watch is not drawn; its limits appear in Warnings. No warnings for one sample does not guarantee that every ticket's content fits. Use the iPhone test for the final appearance. If the preview fails, use Try again; if a test link expires or has already been used, create a new link.

If a syntax error names a field and a language, select that Content language and correct the field before saving or previewing again. Each opening condition needs its matching end condition. For a name or date without a condition, insert the ordinary placeholder instead. Check translations too, even when the error concerns a language you are not currently editing.

Save and use the design

Select Save changes to keep the prepared copy. Undo, Redo, and Discard changes help you adjust or revert unsaved work.

Use the design for an annual pass or another offer

Keep Use for new passes off when the copy is only for a particular offer. Open that offer’s Ticket templates, choose the saved design under Apple Wallet, and select Save templates. See Choose templates for tickets and vouchers for the settings path and assignment precedence.

Change the account fallback

To make the design the account default, enable Use for new passes in Pass, select Save changes, and confirm Use for new passes. The default applies to newly issued passes when no more specific template assignment takes precedence.

The current default cannot be switched off on its own. To replace it, make another saved design the default. Existing installed passes are not automatically replaced by saving or changing a design or its assignment.