# General Translation Integrations: Using translated content
URL: https://generaltranslation.com/en-US/docs/integrations/mintlify/guides/using-translated-content.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: How to serve translated Mintlify docs with multi-language navigation, locale routing, and redirects.

Once the setup pull request is merged, your Mintlify site serves every language you selected. This guide explains what the integration changes in your project so readers land on the right language.

## Multi-language navigation [#navigation]

Locadex converts your `docs.json` navigation into Mintlify's multi-language structure, with one navigation entry per language. Mintlify uses this to render a language switcher and to build the per-language page tree. If your navigation lives in a separate file referenced with `$ref`, Locadex writes the changes there and preserves the `$ref` in `docs.json`.

## URL routing and the default locale [#routing]

Each translated language is served under its own locale segment, such as `/es/...`. By default, setup hides the source-locale prefix, so source pages keep their original paths.

If you turned off **Hide default locale in URL paths** during setup, the source locale is prefixed too, such as `/en/...`.

(See the [configuration reference](/docs/integrations/mintlify/reference/config) for what each mode produces).

## Redirects and localized links [#redirects]

In show-default-locale mode, Locadex localizes the source and destination paths of existing top-level redirects in `docs.json`. It does not create new redirect entries. Locadex also localizes internal links, static URLs, and relative asset references so readers stay within their language while browsing. Links and navigation entries for pages without a translation remain on the source URL. This includes navigation roots: an empty root, or one ending in `/`, stays on the source folder's `index.md` or `index.mdx` when the localized index is missing.

When you run the CLI directly, enable [`options.mintlify.localizeRedirects`](/docs/integrations/mintlify/reference/config#localized-redirects) to add per-locale copies of source-locale redirects after a source page is renamed or removed in the same translation run. Setup-generated configs omit this opt-in setting. The CLI leaves existing entries unchanged and skips locales without a translated destination.

## OpenAPI pages [#openapi]

When your repository contains OpenAPI 3.x specifications in JSON or YAML, Locadex registers the translated specifications in the Mintlify configuration. Mintlify can then serve each specification from its locale path.

OpenAPI registrations outside `navigation.languages` remain attached to the source specification. Registrations inside a target language's navigation point to that locale's translated specification.

## Deploy [#deploy]

The integration only changes files in your repository, so publishing works exactly as it does for any Mintlify project: merge the pull request and let your normal Mintlify deployment build the site. No additional deployment step is required.

## Next steps

- /docs/integrations/mintlify/guides/translating-content
- /docs/integrations/mintlify/guides/managing-translations
- /docs/integrations/mintlify/guides/configuring-mintlify

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.