# 2. Set Up Language & Locale

Once the initial ACC deployments are completed, the next essential step before proceeding with other configurations is setting the **project locales** and defining the **default language**. 

### <mark style="color:red;">What Are Locales?</mark>

**Locales** determine how language-specific content is managed and presented throughout the project. They control:

* How product attribute values and other localizable data are stored and displayed,
* Which languages are available for input and output in Omnitron and Commerce,
* The localization of content across multiple channels and regions.

The locales you define will appear at the top of the Omnitron interface and serve as the basis for content management. For example, you can set `tr-tr` for Turkish and `en-us` for English, enabling you to manage product names, descriptions, or other translatable fields in both languages.

{% hint style="warning" %}
Locales must be defined *before* entering any data into Omnitron. If content is entered before locales are properly configured, re-entry may be required.
{% endhint %}

### <mark style="color:red;">What Is the Default Language?</mark>

The **default language** determines which locale is used in requests and API responses when no specific language is provided by the client. For example, if no `Accept-Language` header is specified in a request, the system will respond using the default language.

This ensures consistency in responses and provides a fallback option for multilingual setups. It also affects system messages, validation errors, and user interface language when a specific language is not explicitly selected.

By default, English is set as the default locale.

<figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FlLZJLORDAMvnsAkdddgL%2FScreenshot%202025-04-08%20at%2015.51.17.png?alt=media&#x26;token=9adb2fe4-3db4-4059-956d-d3c4d2029f6f" alt=""><figcaption></figcaption></figure>

If you plan to use a locale other than English or change the default language, this must be configured through **environment variables** in both the **Commerce** and **Omnitron** services.

{% hint style="danger" %}
The language settings defined via environment variables **must be identical** in both Commerce and Omnitron services. These settings must be applied **immediately after the services are deployed and before any other configuration begins**. Otherwise, language-related issues may arise later during your project setup or runtime.
{% endhint %}

### <mark style="color:red;">Supported Languages in the System</mark>

Below is the list of ISO language codes currently supported by the system:

```ini
ar    ➡ Arabic 🇸🇦
el    ➡ Greek 🇬🇷
kk    ➡ Kazakh 🇰🇿
nl    ➡ Dutch 🇳🇱
pl    ➡ Polish 🇵🇱
ro    ➡ Romanian 🇷🇴
ru    ➡ Russian 🇷🇺
sr    ➡ Serbian 🇷🇸
tr-tr ➡ Turkish 🇹🇷
uk    ➡ Ukrainian 🇺🇦
```

{% hint style="warning" %}
If you require support for a language not listed above, please contact the Akinon team to discuss availability and integration options.
{% endhint %}

### <mark style="color:red;">Setting Language Environment Variables</mark>

To set a default language and supported locales (e.g., Turkish as default along with English), follow the steps below:

{% stepper %}
{% step %}

### Configure Language for Omnitron Service

* Navigate to the **Project Details** page.
* Click on the **Omnitron** service.

<figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FTNz1P5GjVGKowyXKUrgc%2FScreenshot%202025-04-09%20at%2014.16.05.png?alt=media&#x26;token=b33a6688-9bef-4022-b787-219ad9c3d1d3" alt=""><figcaption></figcaption></figure>

* Click the **VIEW ENVIRONMENT VARIABLES** button.

<figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FqOQhxsZV81WCUM9PizE8%2FScreenshot%202025-04-09%20at%2014.20.43.png?alt=media&#x26;token=7f7a57d6-c0e7-40dc-86a4-90cac3ed6d2c" alt=""><figcaption></figcaption></figure>

* Add the following two variables using the **+ NEW ENVIRONMENT VARIABLE** button:\
  \
  \&#xNAN;***For locales:***

  * `Name`: `LANGUAGES`
  * `Value`: `tr-tr=Turkish,en-us=English`&#x20;

  <figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2Fkc7uGqDEb3s4mRAHvVvP%2FScreenshot%202025-04-09%20at%2014.33.58.png?alt=media&#x26;token=9d68dc24-2d2a-42a7-8dba-3b35699dcf5a" alt=""><figcaption></figcaption></figure>

  ***For default language:***

  * `Name`: `LANGUAGE_CODE`
  * `Value`: `tr-tr`

  <figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FsXDBqwfdFf2TKlhVcNVd%2FScreenshot%202025-04-09%20at%2014.34.42.png?alt=media&#x26;token=36b47376-f2d4-4604-a5ac-ae7cccde2849" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Configure Language for Commerce Service

* Return to the **Project Details** page.
* Click on the **Commerce** service.

<figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FKZ9GNuSY7dW960X8SDVi%2FScreenshot%202025-04-09%20at%2014.37.10.png?alt=media&#x26;token=1888621c-7b84-48da-9aa3-1c327bdeea12" alt=""><figcaption></figcaption></figure>

* Click the **VIEW ENVIRONMENT VARIABLES** button.

<figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2Fj5qa4jvxRraQ4BmdSdql%2FScreenshot%202025-04-09%20at%2014.10.27.png?alt=media&#x26;token=83c5b112-bb10-4184-896f-d247604c9b4b" alt=""><figcaption></figcaption></figure>

* Again, add the **same two variables** as configured for Omnitron:\
  \
  \&#xNAN;***For locales:***

  * `Name`: `LANGUAGES`
  * `Value`: `tr-tr=Turkish,en-us=English`&#x20;

  <figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FyysGGcF0O1Sl1o40Fjjl%2Fimage.png?alt=media&#x26;token=aba6755d-bc35-4010-b605-7cb4791ebcb0" alt=""><figcaption></figcaption></figure>

  ***For default language:***

  * `Name`: `LANGUAGE_CODE`
  * `Value`: `tr-tr`&#x20;

  <figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FZsM4A6qbqqLFnT56CAvT%2Fimage.png?alt=media&#x26;token=a6f64e71-0429-483d-80af-f4cc40f7ac83" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Final Step: Redeploy to Apply Language Settings

After adding the language environment variables, the new language settings will only take effect **after a new version is deployed** for both Commerce and Omnitron services.

> 📩 **Please contact the Akinon team** to request a new deployment version for each service.

Once deployment is complete, the newly added locales will become available and selectable within the **Locales** section in **Omnitron Frontend**.

<figure><img src="https://164766933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FszVHHD4skw8SftKawRsw%2Fuploads%2FeG2uI2WYw8VFGbpcMwp0%2FScreenshot%202025-04-09%20at%2015.21.05.png?alt=media&#x26;token=bf67121b-90ce-431f-91cf-2519246face2" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}