# 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 Mintlify documentation and understand what Locadex preserves.
related:
  links:
    - /docs/integrations/mintlify/guides/managing-translations
    - /docs/integrations/mintlify/guides/using-translated-content
    - /docs/integrations/mintlify/guides/configuring-mintlify

---

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 open **Project > Automations**, select **Generate translations and push**, and click **Run now**.

## 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