> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/configure/advanced-configuration/wallet/template-configuration/how-to-create-a-template.md).

# How to Create a Template

Create a pass template by duplicating an existing one, importing a .pttwc file, starting from the pre-built library, or using AI.

## Overview

Creating a pass template is simple and quick. To do this, go to the Template section under the Wallet tab and click on "Create a new template"

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2F02xcTN9h9PJwFOl73mqd%2Fconfigure-how-create-how-create.png?alt=media&#x26;token=066a7893-a80a-4254-b993-c2dd3ac8cca0" alt="How to create a template"><figcaption><p>Check that the Template section is open under the Wallet tab before clicking Create a new template.</p></figcaption></figure>

Several options are available to create a template.

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FXhNl5VyU41CKj302GuCG%2Fconfigure-how-create-how-create-2.png?alt=media&#x26;token=5c909159-2987-410d-9a3a-4bd3408f0453" alt="How to create a template (2)"><figcaption><p>The creation dialog lists every starting point: duplicate, import, pre-built library, and AI.</p></figcaption></figure>

### Duplicate a template

Clicking "duplicate" creates a new template based on an existing one. It retrieves that template's configuration, and only the name differs. The new template can then be modified.

First, choose the existing template to duplicate from the list, then click "ok".

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FsK6R8eZ1Dq0dMmWdltXA%2Fconfigure-how-create-duplicate.png?alt=media&#x26;token=c47ee833-3bdc-45d5-992c-1e89e7150a63" alt="Duplicate a template"><figcaption><p>Verify the template selected in the list is the one to duplicate.</p></figcaption></figure>

Choose a new name to create a new template based on the one selected in the list and click on "confirm template".

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FV3B0lLuJ7bYW916uzz7W%2Fconfigure-how-create-duplicate-2.png?alt=media&#x26;token=2ca379f9-1628-4d9b-86da-c545f1e0b623" alt="Duplicate a template (2)"><figcaption><p>Confirm that the new name differs from every existing template name before confirming.</p></figcaption></figure>

{% hint style="warning" %}
**Keeping the same name overwrites the existing template that was selected, and linked passes will update on their next update. To proceed, click on "I confirm overwrite".**
{% endhint %}

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FKcxFRalLudTy4Ai6ZXXP%2Fconfigure-how-create-if-you-decide-keep-same-name-will.png?alt=media&#x26;token=85b75e44-d052-4b4f-ab51-45642d572af9" alt="Overwrite confirmation dialog shown when the new template reuses an existing template name"><figcaption><p>The overwrite confirmation. Read it carefully: confirming replaces the existing template.</p></figcaption></figure>

### Import a template file

A new template can also be created by importing the configuration of an existing template. For example, a template built in the staging environment can be exported there and imported into production. **⚠️ This only works with a template file from The Wallet Crew.**

First select the template to export, click on the three dots on the right of the template, and choose export configuration. A pttwc file is then downloaded.

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FZntGN7OohAxZdR2F5wZX%2Fconfigure-how-create-import-file.png?alt=media&#x26;token=cf5fad61-5551-4454-a4ac-b8b2a8578828" alt="Import a template file"><figcaption><p>The export configuration action sits in the three-dot menu on the template row.</p></figcaption></figure>

Go back to the creation of a template by clicking on "Create a new template" and choose "Import".

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FE5qMSyRBbnbPQPboSGAn%2Fconfigure-how-create-import-file-2.png?alt=media&#x26;token=39697211-308c-4d5a-9361-64324ba2075c" alt="Import a template file (2)"><figcaption><p>Select Import in the creation dialog.</p></figcaption></figure>

Click on "Upload (template.pttwc)" and select the pttwc file just downloaded.

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2F0BJD2LM42EpVxRsuvI6C%2Fconfigure-how-create-import-file-3.png?alt=media&#x26;token=1b92b198-ab2d-4c43-9851-f0f464869ae6" alt="Import a template file (3)"><figcaption><p>Confirm the uploaded file is the .pttwc file exported from The Wallet Crew.</p></figcaption></figure>

Choose a new name to create a new template based on the imported file, then click on "confirm template".

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2F8e16JfPp0ZLDOsq3x9AU%2Fconfigure-how-create-import-file-4.png?alt=media&#x26;token=b5561e1f-c63b-4ede-bdf6-ea7003c0dd34" alt="Import a template file (4)"><figcaption><p>Check the name field before confirming, so an existing template is not replaced.</p></figcaption></figure>

**⚠️ Choosing a template name that already exists in the template list overwrites the existing template, and linked passes will update on their next update. To proceed, click on "I confirm overwrite".**

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FUc0WJFrCqWK6deGkuVU6%2Fconfigure-how-create-if-you-decide-choose-name-already-existing.png?alt=media&#x26;token=26f0dae9-734e-4d48-b8f6-aa72d5e617c3" alt="Overwrite confirmation dialog shown when an imported template reuses an existing name"><figcaption><p>The overwrite confirmation for an imported template.</p></figcaption></figure>

### Use a pre-built template

The Wallet Crew maintains a centralized template library that covers common use cases. A template created from a pre-built one starts with the same configuration as the pre-built template (colors, images, fields), and that configuration can be kept as is or modified. To access this library, click on "Create a new template", then select "Use a pre-built".

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FemTd8SF7LvT4wqtdOcne%2Fconfigure-how-create-use-pre-built.png?alt=media&#x26;token=0cb2387d-2879-4fe9-b584-9355d13806e0" alt="Use a pre-built template"><figcaption><p>Select Use a pre-built to open the template library.</p></figcaption></figure>

The library offers customer card, event ticket, generic, gift cards, and offer templates. Use [Type of pass](https://docs.thewalletcrew.io/guides-design/) to pick the right starting point for the use case.

Before selecting a pre-built template, the Apple and the Google version can both be previewed.

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2Fc4UUCrcvwCBqAVhl1ub6%2Fconfigure-how-create-use-pre-built-2.png?alt=media&#x26;token=1b9254c6-3ccc-45f8-8e8f-d17bff2afaa2" alt="Use a pre-built template (2)"><figcaption><p>Compare the Apple and Google previews before committing to a pre-built template.</p></figcaption></figure>

Once the choice is made, select the pre-built template by clicking on "Use this template".

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FcI01gDSeYHW0tRqCSIMv%2Fconfigure-how-create-use-pre-built-3.png?alt=media&#x26;token=62a87d8a-37fc-455f-8dfb-e7e8eb0ddc78" alt="Use a pre-built template (3)"><figcaption><p>Use this template confirms the selected pre-built template.</p></figcaption></figure>

Choose a new name to create a new template based on the pre-built one and click on "confirm template".

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2F3FUJyCRPbPxF5GYiOsyI%2Fconfigure-how-create-use-pre-built-4.png?alt=media&#x26;token=7dc6a4d4-f260-4a3b-b4af-b1a8eff03738" alt="Use a pre-built template (4)"><figcaption><p>Name the new template before confirming.</p></figcaption></figure>

**⚠️ Choosing a template name that already exists in the template list overwrites the existing template, and linked passes will update on their next update. To proceed, click on "I confirm overwrite".**

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FUc0WJFrCqWK6deGkuVU6%2Fconfigure-how-create-if-you-decide-choose-name-already-existing.png?alt=media&#x26;token=26f0dae9-734e-4d48-b8f6-aa72d5e617c3" alt="Overwrite confirmation dialog shown when a pre-built template reuses an existing name (2)"><figcaption><p>The same overwrite confirmation appears for a template created from the library.</p></figcaption></figure>

### Start with AI

The Wallet Crew also offers an AI template designer for finding inspiration and ideas before creating a new template. A few things to know before using this tool:

* This tool is in beta mode, which means that it's brand new and may contain errors
* A Google account is required to access this feature
* A template created in the template designer cannot be exported and imported on The Wallet Crew
* The template designer is for now only in French

To use it, click on "Create a new template", then select "Start with AI".

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FpGLBfhVfe7q7lFV6WA78%2Fconfigure-how-create-start-ai.png?alt=media&#x26;token=582e6ee9-ca12-42f4-9d5f-29c9945f121b" alt="Start with AI"><figcaption><p>Start with AI opens the beta template designer.</p></figcaption></figure>

### What's next?

The new template is now created. To modify it, find the recently created template in the list of templates. To access the Apple version, click on the corresponding logo.

From this interface, the loyalty card can be customized as needed:

* Logo and colors of the company
* Customer’s name
* Primary, secondary fields
* Backfields information
* Barcode for identification at the checkout
* Strip

**And much more.**

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FmeaClVN1XXJE771hDIiX%2Fconfigure-how-create-much-more.png?alt=media&#x26;token=3f29b62c-abdd-4a6f-b8c4-8788c7e92a78" alt="Apple version of the template editor with the customizable areas of the card"><figcaption><p>The Apple template editor. Check each area of the card against the brand guidelines.</p></figcaption></figure>

To customize the Android version, simply switch by clicking on "Google". Just like the Apple version, the fields and design of the pass template can be customized there.

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2F6dE0CHJUgr9M3O40g80N%2Fconfigure-how-create-what-x27-s-next.png?alt=media&#x26;token=c7e54f24-7b7c-47fe-ba5b-ee04a95b7edd" alt="Google version of the template editor"><figcaption><p>The Google editor. Verify that the Google version carries the same fields and design intent as the Apple one.</p></figcaption></figure>

To learn more about how to configure a template, start with [Type of pass](https://docs.thewalletcrew.io/guides-design/).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.thewalletcrew.io/configure/advanced-configuration/wallet/template-configuration/how-to-create-a-template.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
