> For the complete documentation index, see [llms.txt](https://docs.mapeo.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mapeo.app/complete-reference-guide/customization-options/translating.md).

# Translating Mapeo & default configurations

Mapeo aims to be accessible to a wide range of communities in their native languages, and to facilitate the process of translating the app and the [default configuration](/complete-reference-guide/will-mapeo-work-out-of-the-box-for-me/default-configuration.md) into new languages as needed.

While [developing custom configurations](/complete-reference-guide/customization-options/custom-configurations.md) currently requires significant technical knowledge, the process of translating Mapeo and the default configuration into a new local language can be an easier way to customize the tool for use in your project.

### Translation using Crowdin

Translations for Mapeo are handled through the [Crowdin](https://crowdin.com) platform. It is free to create an account on Crowdin and anyone can contribute translations to Mapeo for new or existing languages.

To begin translating, visit the project page for the area you would like to translate.

* [Mapeo Mobile](https://crowdin.com/project/mapeo-mobile)\
  Text and titles for screens and buttons in the mobile app
* [Mapeo Desktop](https://crowdin.com/project/mapeo-desktop)\
  Text and titles for screens and buttons in the dekstop app
* [Mapeo's default configuration](https://crowdin.com/project/mapeo-defaut-config)\
  Names of data collection categories, and details fields

![Project page for Mapeo Mobile on Crowdin](/files/IexuNGFUrmKnQsTU7HZb)

#### Viewing available languages

On the project home page you can view all languages currently available for the project and how complete translations are.

#### Adding a new language

If the language you wish to translate is not available on the project home page, contact the Project Owner (listed on the bottom right of the page) to request an addition to the list.

#### Contributing translations

To start translating, create an account with Crowdin, visit the relevant project home page, and select the target language. Click on **Translate All** to bring up all relevant text strings.


---

# 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.mapeo.app/complete-reference-guide/customization-options/translating.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.