> For the complete documentation index, see [llms.txt](https://foodmonkey-docs.natadtech.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://foodmonkey-docs.natadtech.com/usage/translations.md).

# Translations

## The simplest method for translation

{% embed url="<https://youtu.be/DycmSgxmSB4>" %}
placeholder for now
{% endembed %}

## How to Add a New Language

To include a language that is currently missing, log in as an admin and navigate to Translations.

From there, proceed to Languages and click on "+ Add."

<figure><img src="https://3774121173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHgqItXoDo5myLGaKMahI%2Fuploads%2FjBDl7uCswpcsaRWiANph%2Ftranslationadd.jpg?alt=media&amp;token=ddc5a35d-e032-451b-a758-1de0eb612817" alt=""><figcaption></figcaption></figure>

Select the language you wish to add.

<figure><img src="https://3774121173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHgqItXoDo5myLGaKMahI%2Fuploads%2F4XidQW5W9TAkLAby06yD%2Ftranslationlanguage.jpg?alt=media&amp;token=516b7457-0fe0-417c-809c-559039f391e4" alt=""><figcaption></figcaption></figure>

## How to Translate an Existing String

Sign in as an admin and navigate to the Translations section.

Within this section, translation strings are organized into groups. Alternatively, if not grouped, they are displayed individually (Single strings). You can also utilize the search box to quickly locate specific strings. Choose the language you wish to translate to.

Initially, "English" should serve as the default locale, as it contains all the strings available for translation.

<figure><img src="https://3774121173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHgqItXoDo5myLGaKMahI%2Fuploads%2FcKMQbvjMr9M5O2Sp1szv%2Ftranslationeng.jpg?alt=media&amp;token=d4311539-6edc-4927-910b-37ae95c248ef" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3774121173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHgqItXoDo5myLGaKMahI%2Fuploads%2FpRfMRaEXUEJhGHoFjUWI%2Ftranslationcookies.jpg?alt=media&amp;token=7937aeec-5236-4258-8166-27c1b042693a" alt=""><figcaption></figcaption></figure>

Once you've identified the string, click on the pencil button to add the translation.

## How to Add Missing Translation

Some string may be missing from both single or grouped translations. To add missing translations

Click on "+ Add" to introduce a new term

<figure><img src="https://3774121173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHgqItXoDo5myLGaKMahI%2Fuploads%2F5hGGeAN4GRY7oc6ryEqC%2Ftranslationaddmistrans.jpg?alt=media&amp;token=3583349f-80cf-429a-8fbf-7a3fb6ffacf9" alt=""><figcaption></figcaption></figure>

In this section, input the existing string (the text visible on the site, e.g., Platform Fee) and provide your desired translations.

<figure><img src="https://3774121173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHgqItXoDo5myLGaKMahI%2Fuploads%2FWgvq2hfmH6rjPJTBBtUL%2Ftranslationplatform.jpg?alt=media&amp;token=d05ceb82-72a3-4585-bede-864fb66d8b5a" alt=""><figcaption></figcaption></figure>

## Add Language on the Front Page

The language dropdown menu visible on both the front page and in the admin language changer

<figure><img src="https://3774121173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHgqItXoDo5myLGaKMahI%2Fuploads%2FNwmdDIrRwv5yLXVwLZCo%2Fimage.png?alt=media&amp;token=0d56f985-3e82-4b6c-b8cf-ad57bb3cf801" alt=""><figcaption></figcaption></figure>

Is managed through Settings -> Localization.

<figure><img src="https://3774121173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHgqItXoDo5myLGaKMahI%2Fuploads%2FMLxoMcFwlVOlUAwChJf9%2Ftranslationsettings.jpg?alt=media&amp;token=05f04d6f-0938-4a5b-8f36-31f10fdd2261" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Note\
Please make sure you have the following format. SHORTCODE,Language name for example
{% endhint %}

`EN,English,FR,French`

`EN,English`

`EN,English,FR,French,RU,Russian,ES,Spanish`

## Translate the Front Page

To commence translating the front page, log in as an admin, then navigate back to the homepage. You'll have the option to edit the translatable strings in that language.

<figure><img src="https://3774121173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHgqItXoDo5myLGaKMahI%2Fuploads%2Fr5LyEKeeTMa16YfZbaD1%2Ftranslationqrmenu.jpg?alt=media&amp;token=66b67885-94ad-4f3a-8c0b-499cc99cfc9a" alt=""><figcaption></figcaption></figure>

## Missing Translation After Update

We exclusively maintain the English language. With each update, new strings may be added to the **en.json** file or other files within the **en** folder. We include these additions in the list of updated files.

If your website is translated into another language, you'll need to incorporate these missing translations.

The simplest method is to revert the site language back to English. Then, navigate to **Translations** and choose your language along with the group you intend to translate. Typically, you'll only need to translate the **Single** group.

Once you've switched to English, any missing translations will appear as blank. Ensure you fill in these gaps with the appropriate translations. After completing this task, you can switch back to your preferred language.

{% hint style="info" %}
Note\
Another option is to use a tool like PoEditor, which allows you to update the en.json file to maintain full translation coverage.
{% endhint %}