# Translations

The translations are also divided into two areas: ***Custom*** and ***System***.

These variables are used to use texts in the application that do not come from the database. Instead of writing the text directly into the code, so-called translation-variables are used.

You can show all the existing translations using this button:

<div align="left"><figure><img src="/files/YqyXpey1L23aiOXlPqKN" alt=""><figcaption></figcaption></figure></div>

## Custom translations

You can store your own language variables in this section and use them in the code.

### Add language variable

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

In the field `Variable` you can add the desired variable as a string, e.g. *`txtPleaseAddName`,* which you then translate in all the languages you’ve added in saaster.

After you’ve added a variable, you can change the translation at any time.

## System translations

The system translations are added by saaster developers. As a SaaS provider that uses saaster you can use these translations, but cannot delete or add them.

To edit the translations, you can click on the small globe next to the translation. Make sure you display all translations&#x20;

<figure><img src="/files/46xiSE6dYyfRR1gX9x8w" alt=""><figcaption></figcaption></figure>

If you want to contribute to the translation of saaster, you can do this via [GitHub](https://github.com/PAWECOGmbH/saaster).

## Bulk translate

After adding a new language, you can use `Bulk translate` to translate all the content in the corresponding tables in one go. To archive this, saaster uses the DeepL API. Therefor, you also need an API key to use this feature.

You can decide whether you want a free account or the Pro one. Just follow this link and register:<br>

{% embed url="<https://www.deepl.com/pro-api>" %}

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

Select the source language and the language into which you want to translate. You can also select what should get translated. Copy the API key received into the field and click the corresponding button, depending on which version of the API is available.


---

# 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://docs.saaster.io/fundementals/administration/system/translations.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.