---
title: "How to add translations"
manual: "How to Document"
version: "main"
permalink: "https://docs.typo3.org/permalink/h2document:add-translation"
source: "Advanced/HowToAddTranslation.rst"
rendered: "2026-09-22T14:34:53+00:00"
---

# How to add translations {#add-translation}

If you want to add a translation to official documentation or to
your extension documentation, please keep in mind that it must be updated
and maintained long term.

> [!IMPORTANT]
> Before adding a translation to an official manual
> [contact the Documentation Team](https://typo3.org/community/teams/documentation/#c9886).

In general, it is a good idea to keep the structure of the original
language. That way, it is possible to switch the language on each page and
wind up on the corresponding translated page.

1.  Create a localization directory

    for example `Documentation/Localization.de_DE`, `Documentation/Localization.fr_FR`.
    This directory contains a complete documentation project. So, you can effectively
    copy the original `Documentation` directory.

    ```none
    Documentation
    └──  Localization.de_DE
         ├── Index.rst
         └── guides.xml
    ```
1.  Update the file [Documentation/guides.xml](https://docs.typo3.org/permalink/h2document:settings-guides-xml).
1.  Translate the texts
1.  Check the rendering

    [Render the documentation locally with Docker](https://docs.typo3.org/permalink/h2document:rendering-docs)

    The result will be in `/Documentation-GENERATED-temp/Result/project/<locale>/0.0.0/`,
    for example `/Documentation-GENERATED-temp/Result/project/de-de/0.0.0/Index.html`

Once the documentation has been rerendered on the documentation server, you can
switch the language using the version selector.