# Event ticket

Whether you are a new client who needs to create the template for the tickets that will be distributed to your attendees, or a master of The Wallet Crew who needs to update an existing template, this article will help you navigate to our template designer. The goal is to configure a ticket template that will reflect your brand identity, clearly display essential event information, and ensure a smooth and secure experience across Apple Wallet and Google Wallet.

## Architecture

Apple and Google have their own ticket pass templates as you can see below.

{% tabs %}
{% tab title="Apple" %}

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FXKDZiwwRjQg21vPORXtF%2FCapture%20d%E2%80%99e%CC%81cran%202026-01-29%20a%CC%80%2016.03.19.png?alt=media&#x26;token=7ab9c85a-4343-4824-95b5-ff795c09ba92" alt="Architecture - Apple"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Google" %}

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2F4DbQ4CVthEnFYrzySF2Q%2FCapture%20d%E2%80%99e%CC%81cran%202026-01-29%20a%CC%80%2016.03.34.png?alt=media&#x26;token=2ae14341-8e3d-4dbd-b274-db0e60c73ea5" alt="Architecture - Google"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td align="center">Apple ticket</td><td data-object-fit="contain"><a href="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FdZoVYm8J4lFgn2Lbn8sA%2FImage_-_2026-02-12T154141.948-removebg-preview.png?alt=media&#x26;token=fbccd383-2a59-46ed-9b2e-7dacf71b57ed">design-event-ticket-image-2026-02-12t154141-948-removebg-preview.png</a></td></tr><tr><td align="center">Apple ticket</td><td data-object-fit="contain"><a href="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FqJFBcKDqDQ36mI8mZvX6%2FImage_-_2026-02-12T154147.926-removebg-preview.png?alt=media&#x26;token=a68b884a-644b-42ba-bf37-237179831aa1">design-event-ticket-image-2026-02-12t154147-926-removebg-preview.png</a></td></tr><tr><td align="center">Apple ticket</td><td data-object-fit="contain"><a href="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FEb7gv9rfnJz1UvLKPyH8%2FImage_-_2026-02-12T154144.942-removebg-preview.png?alt=media&#x26;token=d4d86b8f-8e1c-4282-ab19-e7270bc14a12">design-event-ticket-image-2026-02-12t154144-942-removebg-preview.png</a></td></tr><tr><td align="center">Google ticket</td><td data-object-fit="contain"><a href="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FvnmDlJMowgfNrmtz0znY%2FCapture_d_e%CC%81cran_2026-04-09_a%CC%80_14.43.48-removebg-preview.png?alt=media&#x26;token=5ddc74e8-4f4b-4c54-a130-e27fa9ec612e">Capture_d_écran_2026-04-09_à_14.43.48-removebg-preview.png</a></td></tr><tr><td align="center">Google ticket</td><td data-object-fit="contain"><a href="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FRV8zEhovmdtpOoRXdfya%2FCapture_d_e%CC%81cran_2026-04-09_a%CC%80_14.42.55-removebg-preview.png?alt=media&#x26;token=c80d6a24-2d0d-400f-84ab-17962b071e85">Capture_d_écran_2026-04-09_à_14.42.55-removebg-preview.png</a></td></tr><tr><td align="center">Google ticket</td><td data-object-fit="contain"><a href="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FZBLtrk52GffEmWPYcJZi%2FCapture_d_e%CC%81cran_2026-02-12_a%CC%80_15.29.03-removebg-preview.png?alt=media&#x26;token=795c2c39-cb7a-4ca5-95fe-4f949810bab5">design-event-ticket-capture-d-e-cran-2026-02-12.png</a></td></tr></tbody></table>

{% hint style="info" %}
**If you want to go further, find all the details of the two versions:**
{% endhint %}

**Apple:**

{% embed url="<https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/PassKit_PG/Creating.html>" %}

**Google:**

{% embed url="<https://developers.google.com/wallet/tickets/events/resources/template?hl=fr>" %}

### How to configure it on The Wallet Crew

With The Wallet Crew, you have access to a **template designer** that allows you to **personalize the event tickets** you will distribute to your clients. Let’s see in detail how to personalize each section!

## Apple

**Let’s take a look at the different sections of the Apple template designer.**

### General section

On the general section, you have two mandatory field that you must fill :

* **Description** : a brief description of the pass, that will appear on the back on the card
* **Organization name** : the name of your company or brand

You also have the possibility of putting a text next to your logo, **activate the sharing of the ticket** if you want your customers to be able to share it or not with other people, the “void feature” for the coupons, a relevant and expiration date that are used for event tickets.

You can also **define the distance** from a relevant latitude and longitude that the pass is relevant, for **geofencing notifications.**

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FnA5LxsBDJnnXCyslg6h4%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-12%20a%CC%80%2010.32.07.png?alt=media&#x26;token=2791c482-c384-461b-82e0-be7700cdf8cd" alt="Event ticket - General section Apple"><figcaption></figcaption></figure>

### Barcode

Choose the **type of barcode** that is compatible with your control hardware. The barcode value corresponds to the **identifiers** that will allow you to identify the event ticket with your control terminal at the entrance. Finally, the alternate text can be used to display the barcode data in case the barcode cannot be scanned.

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FtCCjJRHuXLwC3SSTiQAf%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-12%20a%CC%80%2010.23.21.png?alt=media&#x26;token=287c10e3-b7a5-4c15-ae19-7f668b2c7ba7" alt="Event ticket - Barcode Apple"><figcaption></figcaption></figure>

### Colors & Images

To change the background color of your ticket, simply **add the color code in the fields** provided for this purpose. To add an image, upload it from your device.

### Header Fields <a href="#header-fields" id="header-fields"></a>

This section is particularly important in the Apple version, as the tickets are **stacked on top of each other**. Only the header of the ticket remains visible. Therefore, it is important that this section catches the eye and encourages clicking on the card, especially by displaying the most important information such as the date, or other relevant information.

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FMtEsn98cWn8nbx7dgr3r%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-12%20a%CC%80%2010.31.03.png?alt=media&#x26;token=22402c20-36a0-4de8-9bcc-1e0f29d82140" alt="Event ticket - Header fields Apple"><figcaption></figcaption></figure>

### Front fields

The front fields are the fields that are used to **display information in the recto of the ticket**, under the strip image. The label you will choose is the same for every user (per language), but you can customize the value to display the name of the event or the customer's seat.

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2F35DjAyg3tycQ7HzAzz6B%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-12%20a%CC%80%2010.30.32.png?alt=media&#x26;token=0b1f3957-b09a-4127-938d-107bcc28403f" alt="Event ticket - Front field Apple"><figcaption></figcaption></figure>

{% hint style="warning" %}
**To personalize the front fields please refer to your tech team to find which dynamic value you have to write.**
{% endhint %}

### Backfields <a href="#backfields" id="backfields"></a>

This section, located on the back of the event ticket, includes several useful pieces of information for the customer:

* How to get to the event
* Information regarding entrance
* Receipts
* The ability to add links, such as a link to listen to the artists, access to the terms and conditions, etc.

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FkNbpYVMc27ZYHjHoj1Pj%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-12%20a%CC%80%2010.34.39.png?alt=media&#x26;token=9e52d0ef-d22a-4660-866b-a427249584ba" alt="Event ticket - Backfields Apple"><figcaption></figcaption></figure>

### Other sections

On Apple, you also have four other sections :

* **Locations** : Used for geofencing notifications.
* **Beacons** : Also used for geofencing notifications.
* **Associated store identifier** : You can link your application if it's located on Apple Store
* **NFC** : A feature that allows customers to exchange digital content, and connect electronic devices with a touch.

{% hint style="warning" %}
**Please contact your The Wallet Crew representative to activate these features**
{% endhint %}

{% hint style="danger" %}
**Once you’ve done some modifications, don’t forget to click on “save” on the top of your screen!/**
{% endhint %}

***

## Google

**The Google template designer is a bit different than the Apple one.**

{% hint style="warning" %}
**Here are a few things you need to know before configuring your Google template:**
{% endhint %}

1. Some fields such as “issue” and “program name” are **mandatory**
2. Google preconfigures the fields based on their intended values, so it’s best not to enter the customer’s name in the Event name for example, even if that’s how you’d like it to appear on the pass
3. Dynamic values (e.g., {{firstName}}) should be **placed in dedicated dynamic fields**. ‘Label’ fields are intended for static text only.

**Let’s take a look at the different sections.**

### General section

On the general section, you have three **mandatory fields** that you must fill :

* **Issuer**: the name of the brand or company that issues the ticket
* **Event name**: it appears on the front of the pass, it can be the name of your event
* **State**: the state of your ticket (active, expired, completed, inactive)

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FHkEzTWWqhX7glh83muxY%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-12%20a%CC%80%2010.47.20.png?alt=media&#x26;token=88d19447-4c3e-4e8e-a130-39c7fcee5400" alt="Event ticket - Google general"><figcaption></figcaption></figure>

### Barcode

Choose the **type of barcode** that is compatible with your control hardware. The barcode value corresponds to the **identifiers** that will allow you to identify the event ticket with your control terminal at the entrance. Finally, the alternate text can be used to display the barcode data in case the barcode cannot be scanned.

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FFYxk6phGs1F7SpaXdGHO%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-12%20a%CC%80%2010.50.27.png?alt=media&#x26;token=7001d65c-5a8d-43a8-9938-82e14e2216c5" alt="Event ticket - Barcode Google"><figcaption></figcaption></figure>

### Security

When you configure a template, you need to decide **whether the customer can share their pass or not**. Regarding Google you have three option:

* **Multiple holders**: it means that the customer can share their pass with anyone
* **One user all device**: a customer but with several devices (a watch for example)
* **One user one device**

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Ff3xNM3HFDcFRnqNS8YeX%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-12%20a%CC%80%2010.51.18.png?alt=media&#x26;token=5ce7728e-af0f-43ff-b05b-e475bef2bf31" alt="One user one device"><figcaption></figcaption></figure>

### Colors & Images

To change the background color of your ticket, simply **add the color code in the fields** provided for this purpose. To add an image, upload it from your device.

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FVPoymdlEHTXVl3Npy8L6%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-12%20a%CC%80%2010.52.49.png?alt=media&#x26;token=e30a1f50-f23e-4f93-a573-06db7f7171cf" alt="Event ticket - Colors and Images Google"><figcaption></figcaption></figure>

### Venue

A section to enter the detail of where the event will take place!

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FN1XC5CeHi6OT5nfP6gOx%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-12%20a%CC%80%2010.55.55.png?alt=media&#x26;token=feb93d99-a045-405f-acd9-294ed1670aea" alt="Event ticket - venue Google"><figcaption></figcaption></figure>

### Placement

You can define the gate, row, seat and section of your customer's ticket. Each field is optional.

{% hint style="warning" %}
**To personalize the placement fields please refer to your tech team to find which dynamic value you have to write.**
{% endhint %}

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FrB2dhxufCtgJD4auhdTi%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-12%20a%CC%80%2010.58.06.png?alt=media&#x26;token=b8ca5506-4c5c-4c90-b96f-85e7a9f42df4" alt="Event ticket - Placement Google"><figcaption></figcaption></figure>

### Confirmation

On the Google template, you can also define and display a confirmation code if it's required for your event. This is an optional field, if you don't have any confirmation code, you can select "Unspecified".

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FGAgJjX69ZE6ALm3Wn9TF%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-12%20a%CC%80%2011.00.25.png?alt=media&#x26;token=3b0cc6cb-addc-45bc-a329-8fd1ace3c037" alt="Event ticket - Confirmation Google"><figcaption></figcaption></figure>

### Additional links, Smart tap and Valid Time Interval

You can decide to add **additional links** to the customer's ticket, for exemple the event website link!

Furthermore, you can also configure the **Smart tap feature** that allows your customer to simply **validate their ticket** by taping their device on your compatible hardware terminal.

Finally, the Valid time interval section allows you to **define a start and an end date** to your event!

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FbSna5Pu9A2gqbyzdf8mG%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-12%20a%CC%80%2011.08.14.png?alt=media&#x26;token=969caeaf-0e14-4100-9216-7feeec01dc64" alt="Event ticket - Smart tap Google"><figcaption></figcaption></figure>

### Messages

This section, located on the back of the event ticket, includes several useful pieces of information for the customer:

* How to get to the event
* Information regarding entrance
* Receipts
* The ability to add links, such as a link to listen to the artists, access to the terms and conditions, etc.

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2F1DYFhscVVNMhNIj95aEL%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-12%20a%CC%80%2011.03.19.png?alt=media&#x26;token=6609f96b-ba6e-47df-8d59-a8ff3e944136" alt="Event ticket - Backfields Google"><figcaption></figcaption></figure>

### Value added opportunities

This section allows you to add a **small section at the bottom of the ticket**. This is used to display offers, or news.

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FL1htskLpU4HUAT1NeezP%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-12%20a%CC%80%2011.09.53.png?alt=media&#x26;token=ca87f5c7-4bc4-491a-bbca-b19adf95139d" alt="Event ticket - Value Added Opportunity Google"><figcaption></figcaption></figure>

### Other sections

On Google, you also have four other sections :

* **Face Value** : The price of the ticket
* **App links** : Used to add a link for an application
* **Homepage** : Used to add the link of the event website
* **Locations** : Used for geofencing notifications

{% hint style="danger" %}
**Once you’ve done some modifications, don’t forget to click on “save” on the top of your screen!**
{% endhint %}

## FAQ

<details>

<summary><strong>Do I need to save my configuration and update all the passes at the same time?</strong></summary>

Once you've done editing your template, you have **two options:**

* Saving your configuration without pushing an update on all passes: this is the best option is you have a lot of passes. You can save your configuration and decide to schedule an update during the night to avoid the impact of mass updating.
* Saving your configuration and pushing an update: this is the best option if you are doing some tests or have a few passes in your environment.

</details>

<details>

<summary><strong>How to modify the configuration for another language?</strong></summary>

You have the ability to modify the design of the pass for each language. If you click on "general" in the menu, you can add a language. You'll then see it appear on the template designer and will be able to edit it.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.thewalletcrew.io/design/event-ticket.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
