# Translations

### Introduction

This feature enhances the **Omega Cookie Banner** functionality by allowing merchants to manually translate the text within their cookie banner, categories, and individual cookie descriptions. It provides a comprehensive approach to customizing the user experience for a global audience.

### Translation Detection Methods

The system offers four methods to determine the appropriate language for displaying the cookie banner, categories, and descriptions:

1. **From Subdirectories**: ex: domain.com/en App identifies the language by checking the URL path. For example, if the URL contains **`/en`**, it detects English; if `/fr`, it detects French.
2. **From Subdomain**: App determines the language by analyzing the subdomain. For instance, `en.domain.com` is recognized as English, while fr.domain.com is French.
3. **From URL parameters**: URL detection works if URL path starts with the language locale. e.x. <https://domain.com/de>.
4. **From Browser language**: User's browser detection will automatically match the language with languages of customer's browser.
5. **From Visitor’s IP:** Customer's IP detection will automatically match the geography of customer.

<figure><img src="https://2318858719-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FW2p9hq5wszKFLB4G9Z0l%2Fuploads%2FwPT5VuwSnsqhKMXAXNew%2Fimage.png?alt=media&#x26;token=99a3665a-5813-49b9-84e7-28516bbbdfbf" alt=""><figcaption></figcaption></figure>

### Translation Feature Setup

#### Enabling the Translation Feature

Merchants can activate or deactivate the manual translation feature as needed.

#### Selecting Detection Method

Choose the preferred method for detecting which language to present to the user.

#### Language Scopes Selection

Define the languages into which the merchant wishes to translate the cookie banner, categories, and cookie descriptions.

#### Translation Process

The translation process involves a few steps:

1. **Choose Language**: Select from the list of languages the merchant wishes to provide translations for.
2. **Translate Texts**: Manually input translations for the text of the cookie banner, each category, and individual cookies.
3. **Save Translations**: After translating the texts, save the changes to apply them to the cookie banner.

<figure><img src="https://2318858719-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FW2p9hq5wszKFLB4G9Z0l%2Fuploads%2FTETLPcPNcYRHuqO5pdLn%2Fimage.png?alt=media&#x26;token=1354edd6-caf1-496d-9c34-b1e8a49951e8" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2318858719-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FW2p9hq5wszKFLB4G9Z0l%2Fuploads%2FNaKkixu2IuuC3eNEjfQT%2Fimage.png?alt=media&#x26;token=70d7b3d8-9941-4ba7-9e6d-0fe896715bf8" alt=""><figcaption></figcaption></figure>

#### Additional Translation Settings

* **Default Language**: In the text customization settings, merchants can choose a default language that will be displayed if no language match is found.
* **Pre-translated Templates**: For some common languages, the app provides pre-translated texts, which are indicated with a "Template" badge.

<figure><img src="https://2318858719-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FW2p9hq5wszKFLB4G9Z0l%2Fuploads%2FPgi0t9yehQUbx9L9E65c%2Fimage.png?alt=media&#x26;token=f0129303-2840-4bcd-8871-427a0a15cb14" alt=""><figcaption></figcaption></figure>

### Best Practices for Translation

* **Consistency**: Ensure that the tone and terminology are consistent across all translations.
* **Cultural Sensitivity**: Be mindful of cultural nuances and expressions when translating texts.
* **Professional Translation**: For accuracy, consider using professional translation services, especially for legal texts.

By offering manual translation capabilities, this feature empowers merchants to engage with a diverse customer base in a localized and user-friendly manner. It not only improves the user experience but also demonstrates a commitment to accessibility and compliance with international privacy laws.