> For the complete documentation index, see [llms.txt](https://docs.saaster.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.saaster.io/fundementals/administration/system/translations.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.saaster.io/fundementals/administration/system/translations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.