# Generic

The Generic pass is the most flexible pass type available. It is designed for use cases that don’t naturally fit into one of the dedicated templates such as loyalty cards, gift cards, offers, or tickets. If your pass doesn’t match a predefined category but still needs to be distributed through Apple Wallet or Google Wallet, the Generic template is likely the right choice.

Use a Generic pass when you need a flexible layout that does not fit a dedicated template (loyalty, gift card, offer, ticket).

**Typical use cases:**

* Membership cards that are not loyalty programs
* Partner or staff badges
* Utility passes (warranty card, pickup card, service card)
* Vouchers that are not discounts (free item, perk, entitlement)

If you’re unsure, start from [Type of pass](https://docs.thewalletcrew.io/design/general) and pick **Generic** only as a fallback.

### Architecture (Apple vs Google)

Apple and Google each provide their own Generic template structure.

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

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fgit-blob-d102f2aa656f4a68c3ccf34b4a2c541c35533336%2Fgeneric_1.png?alt=media" alt="The Wallet Crew generic - Architecture Apple"><figcaption><p>Apple generic pass template</p></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%2Fgit-blob-4b03136d461ff2e4b09df39614c1b6934ee9e799%2Fgeneric_2.png?alt=media" alt="The Wallet Crew generic - Architecture Google"><figcaption><p>Google generic pass template</p></figcaption></figure>
{% endtab %}
{% endtabs %}

{% 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/reference/rest/v1/genericclass>" %}

### 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 generic passes 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, and the **“void feature” for the pass**.

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%2F8qITKcJ2XbliBs9cIUAO%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-20%20a%CC%80%2011.16.16.png?alt=media&#x26;token=c24dbc2b-ad35-40f5-b377-484a7019710a" alt="The Wallet Crew Generic - Apple 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 pass in store. 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%2FElBVrgz426zcEQpPOuUO%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-20%20a%CC%80%2011.17.14.png?alt=media&#x26;token=84226bee-683b-443a-b6e3-b437cca32de6" alt="The Wallet Crew generic - Barcode Apple"><figcaption></figcaption></figure>

### Colors & Images

To change the background color of your pass, 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 offers are **stacked on top of each other**. Only the header of the offer pass 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 name of the customer.

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FVB3My30wM7Vc3JtHRiKN%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-20%20a%CC%80%2011.18.13.png?alt=media&#x26;token=83c75acd-2af8-462b-9f27-f0cc205c7333" alt="The Wallet Crew Generic - 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 pass**, 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 expiry date for example.

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2F1yUrdAH6Peg0YoQlnO9L%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-20%20a%CC%80%2011.19.38.png?alt=media&#x26;token=e2db5834-a3d5-40d3-bb43-f5479a4ad52f" alt="The Wallet Crew generic - Front fields 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**

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

* Expiry date
* Information regarding the brand
* Receipts
* The ability to add links, such as a website link

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FhsD5CUczcSePasoimp6j%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-20%20a%CC%80%2011.20.56.png?alt=media&#x26;token=c4f68390-2160-44db-ae6c-e9c3cc396b77" alt="The Wallet Crew generic - 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 “General ” and “Header” are **mandatory**
2. Google preconfigures the fields based on their intended values
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 :

* **General**: the title of the pass.
* **Header:** the header of the pass
* **Sub Header :** the subheader of the pass, such as location where this pass can be used
* **State:** the state of the object.

<figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FpXWYjQZXMiT21TCQAAE7%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-20%20a%CC%80%2011.41.28.png?alt=media&#x26;token=a9228356-28d0-4c2d-a796-4821789484fc" alt="The Wallet Crew generic - General 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%2FQfFuvT7HblBMJ1vIGQPL%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-20%20a%CC%80%2011.42.14.png?alt=media&#x26;token=2ebd4f9e-bcd6-4144-afff-ed45fd56d84e" alt="The Wallet Crew generic - Security Google"><figcaption></figcaption></figure>

### Colors & Images

To change the background color of your pass, 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%2FSPOFnQ8eBJ0CD8uoz0uz%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-20%20a%CC%80%2011.44.22.png?alt=media&#x26;token=4522c863-2c33-4f5c-918b-396a131d9559" alt="The Wallet Crew Generic - Colors and images Google"><figcaption></figcaption></figure>

#### Additional links, Smart tap and Valid Time Interval <a href="#additional-links-smart-tap-and-valid-time-interval" id="additional-links-smart-tap-and-valid-time-interval"></a>

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

Furthermore, you need to configure the **Smart tap feature** that allows your customer to simply **validate their pass** 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 pass!

### Value added opportunities

This section allows you to add a **small section at the bottom of the pass**. 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%2F87q6ZPm3GYPlCRv8gs1l%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-20%20a%CC%80%2011.47.18.png?alt=media&#x26;token=54f6f92c-18dc-4bda-9702-c33bdfb2afd1" alt="The Wallet Crew Generic - Value added opportunities Google"><figcaption></figcaption></figure>

### Other sections

On Google, you also have four other sections :

* **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 %}

### Next steps

* For design guidelines, start with [Card design](https://docs.thewalletcrew.io/design/broken-reference).
* To distribute the pass, use [Distribution (SDK)](https://docs.thewalletcrew.io/design/broken-reference).


---

# 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/generic.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.