> 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-translate-a-template.md).

# How to Translate a template

Add languages to a tenant, translate pass template fields one by one, and bulk-edit translations through Excel export and import.

## **Importance of multilingual cards**

In the retail or the event worlds, it is crucial to offer cards in different languages to cater to an increasingly international clientele. Providing a multilingual pass also helps avoid any misinterpretation, which is particularly essential during events.

### **Steps to manage translations of a pass template**

Go to "Settings" then to "General".

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FKv1CvhOgRe89UkX2g4Ip%2Fconfigure-how-translate-steps-manage-translations-pass.png?alt=media&#x26;token=dad379f0-ddfb-4e8d-9553-5508238337ae" alt="Settings menu with the General entry selected"><figcaption><p>Translations start from the General settings screen.</p></figcaption></figure>

The internationalization section is where languages are added. For example, to add the Spanish language, simply enter the ISO code for the language, which is "es". Then, click on the small cross to confirm before saving.

**The ISO code of a language can be found** [**right here**](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes)**{target="\_blank"}.**

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FMkq48ACvHgo4yUhh7F5C%2Fconfigure-how-translate-you-can-find-iso-code-language.png?alt=media&#x26;token=5f84c476-5766-4e75-88ae-b1b7c288bd97" alt="Internationalization section with an ISO language code being entered"><figcaption><p>Check that the two-letter ISO code is the correct one for the language being added.</p></figcaption></figure>

As many languages as needed can be added.

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FRhyUNsi3y849brLGmn72%2Fconfigure-how-translate-steps-manage-translations-pass-2.png?alt=media&#x26;token=4e7cf73d-bba9-49b6-a29e-7f1225848abe" alt="Internationalization section listing several configured languages"><figcaption><p>Verify that every language the programme needs appears in this list.</p></figcaption></figure>

To set a default language, just click on the chosen language. Don't forget to click on "save" on the top of the screen.

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FFg5pmQan189TlDidw3tg%2Fconfigure-how-translate-steps-manage-translations-pass-3.png?alt=media&#x26;token=2b074e01-3e01-4a4d-a8d5-b5fa7a274243" alt="Language list with the default language selected"><figcaption><p>Confirm the default language before saving.</p></figcaption></figure>

In the template menu, the newly added languages now appear on the selected template. Click on one of them to preview the card.

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FZMaQv6XFbaFyRqWFcyfb%2Fconfigure-how-translate-now-menu-select-you-will-find-newly.png?alt=media&#x26;token=a263e394-ac03-4f1c-acd7-8768030963f6" alt="Template editor showing the newly added languages above the card preview"><figcaption><p>Switch between languages here to preview the card in each one.</p></figcaption></figure>

To translate a field, click on this small icon:

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2F6m6YbpXNq7y929iORh2x%2Fconfigure-how-translate-translate-field-click-this-small-icon.png?alt=media&#x26;token=39708c35-4531-4f27-b1bb-47e61f0261a5" alt="Translation icon displayed next to a translatable template field"><figcaption><p>Only fields showing this icon can be translated.</p></figcaption></figure>

Each language can then be translated in turn.

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2F4pqeDApEraLDcXZomu3r%2Fconfigure-how-translate-you-will-have-option-translate-according-languages.png?alt=media&#x26;token=eec61e82-dab0-424c-9897-eeb11d7babda" alt="Field translation dialog with one input per configured language"><figcaption><p>Check that every configured language has a value before closing the dialog.</p></figcaption></figure>

⚠️ **Only a field that has the translation icon can be translated.**

### **Steps for bulk translation**

With many languages, translating fields one by one in the template editor is slow. Bulk editing is available instead, from the "Locales" section in the "Tools" menu.

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FiUsj3ouU0i5KVuRAdk5Y%2Fconfigure-how-translate-steps-bulk-translation.png?alt=media&#x26;token=eab43cce-c11a-45eb-a145-8855616553e8" alt="Tools menu with the Locales section selected"><figcaption><p>Bulk translation lives under Tools → Locales.</p></figcaption></figure>

Choose the pass template to translate, click on the three dots on the right and click on "bulk edit".

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2Fhc8mZ2SXDwnIXExkrzOX%2Fconfigure-how-translate-steps-bulk-translation-2.png?alt=media&#x26;token=79ba07ab-fba6-4035-970f-743d2f1f4d5c" alt="Locales list with the bulk edit action open in the three-dot menu"><figcaption><p>Confirm the selected template before opening bulk edit.</p></figcaption></figure>

From this interface, all the fields can be translated.

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FC6BaLAftJiCxqPyUSchF%2Fconfigure-how-translate-steps-bulk-translation-3.png?alt=media&#x26;token=86d95350-fd62-4eba-975c-20acd45a988e" alt="Bulk edit grid listing template fields and their translations"><figcaption><p>The bulk edit grid shows every field and every language side by side.</p></figcaption></figure>

Fields highlighted in orange indicate that they have not yet been translated. Simply translate the fields to the corresponding language before saving.

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FtyiN2MnrWVaass6Yvqnh%2Fconfigure-how-translate-steps-bulk-translation-4.png?alt=media&#x26;token=b973b0ef-d3e8-4d1c-9e7b-edf4faecc6a0" alt="Bulk edit grid with untranslated fields highlighted in orange"><figcaption><p>Orange cells are the ones still missing a translation.</p></figcaption></figure>

The file can be exported in Excel format for easier handling.

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FbEfjbtzMZJkDeUbtvttH%2Fconfigure-how-translate-steps-bulk-translation-5.png?alt=media&#x26;token=58d76542-7281-421a-bb68-b4d10abc122f" alt="Export action in the bulk translation screen"><figcaption><p>Export produces the Excel file used for offline translation.</p></figcaption></figure>

Once the Excel file has been modified, it can be imported back into The Wallet Crew.

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FI0Ea0NmQvYuQR9EjMtIH%2Fconfigure-how-translate-once-you-ve-done-modifying-excel-file.png?alt=media&#x26;token=006b8fb6-432b-43cf-9944-076bd639088d" alt="Import action used to upload the translated Excel file"><figcaption><p>Import the translated file, then check the grid no longer shows orange cells.</p></figcaption></figure>


---

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