# General Translation Integrations: Translating content
URL: https://generaltranslation.com/en-US/docs/integrations/mintlify/guides/translating-content.mdx
---

title: Translating content
description: "How to translate your Mintlify documentation with General Translation: this guide covers what Locadex translates and preserves."
related:
  links:
    - /docs/integrations/mintlify/guides/managing-translations
    - /docs/integrations/mintlify/guides/using-translated-content
    - /docs/integrations/mintlify/guides/configuring-mintlify

---

# Translating content

Once your repository is connected, Locadex translates your Mintlify docs and opens a pull request with the results. This guide explains how a translation run works and what it does and does not change.

## Run the first translation [#first-run]

The initial translation happens as part of setup. After you link your repository and choose languages, Locadex:

1. Generates the General Translation configuration tuned for Mintlify.
2. Restructures your `docs.json` navigation into a multi-language layout, one entry per locale.
3. Translates your Markdown and MDX files and `docs.json` labels.
4. Opens a pull request with the configuration, the restructured navigation, and the translated files.

Review the pull request and merge it to publish your translated docs. You can also start a run yourself at any time with **Run Agent** in **Locadex > Agent**.

## What gets translated [#translated]

Locadex translates the human-readable content in your docs:

- All `.mdx` and `.md` pages — headings, paragraphs, lists, tables, and callouts.
- Frontmatter fields such as page titles and descriptions, so your metadata works in every language.
- Reusable [snippets](https://mintlify.com/docs) and the navigation labels in `docs.json`.

For the exact file globs and the repository files that are always excluded, see [Supported content](/docs/integrations/mintlify/reference/supported-content).

## What is preserved [#preserved]

Translation happens at the Markdown and MDX syntax level, so your structure and code stay intact:

- Code blocks, inline code, and syntax highlighting are left untouched — only comments and documentation strings are translated.
- Custom components, links, and formatting come through exactly as authored.
- General Translation adds stable heading anchor IDs so in-page links keep working across languages.

## Context-aware translation [#context]

Translations are produced by AI agents that understand technical terminology and the surrounding content, so meaning and product terms stay consistent across languages. To steer terminology and tone across your Project, define translation context in the Dashboard. See [Define translation context](/docs/platform/dashboard/guides/adding-translation-context).

## Next steps

- /docs/integrations/mintlify/guides/managing-translations
- /docs/integrations/mintlify/guides/using-translated-content
- /docs/integrations/mintlify/guides/configuring-mintlify