# Adding new languages

If the language you're trying to translate is not yet in OpenBoxes or Crowdin, the following instructions outline how to get the language added.

## Requesting a new language

If you're not a project administrator, get in contact with us by posting to the [OpenBoxes Slack](http://slack-signup.openboxes.com/), [adding a post to our community forums](https://community.openboxes.com/), or by [creating a new GitHub Issue](https://github.com/openboxes/openboxes/issues). Let us know the language that you'd like to translate and we'll get you set up as quickly as possible.

## Adding a new language

If you're a project administrator, the following are instructions on how to add a new langugage into OpenBoxes and make it translatable in Crowdin.

### Adding a language to Crowdin

Translated languages in Crowdin are known as "target languages". To add a new target language, navigate to the project settings > Languages, then simply select any new langugages that we want to support.

<figure><img src="/files/Pcu2dP5EGP3TeQImP68I" alt=""><figcaption></figcaption></figure>

This should cause Crowdin to automatically create a pull request into the openboxes repository containing a new `messages.properties` file for the language.

See [Crowdin's documentation](https://support.crowdin.com/project-settings/languages/#target-languages) for additional information.

The following video covers everything required to configure Crowdin (plus also explains how the In-Context feature works):

{% embed url="<https://www.youtube.com/watch?v=ktfw7UsW3qw>" %}

### Adding a language to OpenBoxes

Edit the `application.yml` file and add the [two letter locale code](https://simplelocalize.io/data/locales/) of the new language to the `supportedLocales` property:

```
openboxes:
    locale:
        supportedLocales: [...]
```

After redeploying the application, the new language should be selectable in the list of locales in the website footer.

<figure><img src="/files/oIaFMNDCj2ogheSEYqrV" alt=""><figcaption></figcaption></figure>


---

# 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://openboxes.gitbook.io/contributor-guide/translations/adding-new-languages.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.