From 660153ab27211d1a89f3d8457957c97f15e93665 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Mon, 9 Mar 2026 21:24:48 +0000
Subject: [PATCH 1/4] Document localized footer and navbar for multi-language
sites
Generated-By: mintlify-agent
---
guides/internationalization.mdx | 71 +++++++++++++++++++++++++++++++++
organize/navigation.mdx | 50 ++++++++++++++++++++++-
organize/settings.mdx | 23 ++++++++++-
3 files changed, 142 insertions(+), 2 deletions(-)
diff --git a/guides/internationalization.mdx b/guides/internationalization.mdx
index 69853aef0..11d3c6947 100644
--- a/guides/internationalization.mdx
+++ b/guides/internationalization.mdx
@@ -195,6 +195,77 @@ To add global navigation elements that appear across all languages, configure th
}
```
+### Localized footer and navbar
+
+Each language entry in the `languages` array can include its own `footer` and `navbar` configurations. This allows you to translate footer links, navbar labels, and call-to-action buttons for each language.
+
+```json docs.json
+{
+ "navigation": {
+ "languages": [
+ {
+ "language": "en",
+ "footer": {
+ "socials": {
+ "x": "https://x.com/mintlify"
+ },
+ "links": [
+ {
+ "header": "Resources",
+ "items": [
+ { "label": "Documentation", "href": "/en/docs" },
+ { "label": "Blog", "href": "https://mintlify.com/blog" }
+ ]
+ }
+ ]
+ },
+ "navbar": {
+ "links": [
+ { "label": "Docs", "href": "/en/docs" }
+ ],
+ "primary": {
+ "type": "button",
+ "label": "Get Started",
+ "href": "/en/quickstart"
+ }
+ },
+ "groups": [...]
+ },
+ {
+ "language": "es",
+ "footer": {
+ "socials": {
+ "x": "https://x.com/mintlify"
+ },
+ "links": [
+ {
+ "header": "Recursos",
+ "items": [
+ { "label": "Documentaci贸n", "href": "/es/docs" },
+ { "label": "Blog", "href": "https://mintlify.com/blog" }
+ ]
+ }
+ ]
+ },
+ "navbar": {
+ "links": [
+ { "label": "Documentaci贸n", "href": "/es/docs" }
+ ],
+ "primary": {
+ "type": "button",
+ "label": "Comenzar",
+ "href": "/es/quickstart"
+ }
+ },
+ "groups": [...]
+ }
+ ]
+ }
+}
+```
+
+Language-specific footer and navbar configurations override the global settings defined at the root level of `docs.json`. If a language does not specify a `footer` or `navbar`, it inherits the global configuration.
+
## Maintain translations
Keep translations accurate and synchronized with your source content.
diff --git a/organize/navigation.mdx b/organize/navigation.mdx
index 6ec3dbbb4..168b67763 100644
--- a/organize/navigation.mdx
+++ b/organize/navigation.mdx
@@ -574,7 +574,7 @@ Partition your navigation into different languages. Languages are selectable fro
alt="Decorative graphic of a language switcher."
/>
-In the `navigation` object, `languages` is an array where each entry is an object that requires a `language` field and can contain any other navigation fields, including language-specific banner configurations.
+In the `navigation` object, `languages` is an array where each entry is an object that requires a `language` field and can contain any other navigation fields, including language-specific banner, footer, and navbar configurations.
We currently support the following languages for localization:
@@ -618,6 +618,30 @@ We currently support the following languages for localization:
"content": "馃殌 Version 2.0 is now live! See our [changelog](/en/changelog) for details.",
"dismissible": true
},
+ "footer": {
+ "socials": {
+ "x": "https://x.com/mintlify"
+ },
+ "links": [
+ {
+ "header": "Resources",
+ "items": [
+ { "label": "Documentation", "href": "/en/docs" },
+ { "label": "Blog", "href": "https://mintlify.com/blog" }
+ ]
+ }
+ ]
+ },
+ "navbar": {
+ "links": [
+ { "label": "Docs", "href": "/en/docs" }
+ ],
+ "primary": {
+ "type": "button",
+ "label": "Get Started",
+ "href": "/en/quickstart"
+ }
+ },
"groups": [
{
"group": "Getting started",
@@ -631,6 +655,30 @@ We currently support the following languages for localization:
"content": "馃殌 隆La versi贸n 2.0 ya est谩 disponible! Consulta nuestro [registro de cambios](/es/changelog).",
"dismissible": true
},
+ "footer": {
+ "socials": {
+ "x": "https://x.com/mintlify"
+ },
+ "links": [
+ {
+ "header": "Recursos",
+ "items": [
+ { "label": "Documentaci贸n", "href": "/es/docs" },
+ { "label": "Blog", "href": "https://mintlify.com/blog" }
+ ]
+ }
+ ]
+ },
+ "navbar": {
+ "links": [
+ { "label": "Documentaci贸n", "href": "/es/docs" }
+ ],
+ "primary": {
+ "type": "button",
+ "label": "Comenzar",
+ "href": "/es/quickstart"
+ }
+ },
"groups": [
{
"group": "Getting started",
diff --git a/organize/settings.mdx b/organize/settings.mdx
index cdffee6dd..9ee823e2b 100644
--- a/organize/settings.mdx
+++ b/organize/settings.mdx
@@ -532,7 +532,28 @@ This section contains the full reference for the `docs.json` file.
- Language switcher for [multi-language](/organize/navigation#languages) sites.
+ Language switcher for [multi-language](/organize/navigation#languages) sites. Each language entry can include language-specific `banner`, `footer`, and `navbar` configurations in addition to the navigation structure.
+
+
+
+ Language code in ISO 639-1 format.
+
+
+ Whether this is the default language.
+
+
+ Language-specific banner configuration. See [banner](/organize/settings#banner) for available options.
+
+
+ Language-specific footer configuration. See [footer](/organize/settings#footer) for available options.
+
+
+ Language-specific navbar configuration. See [navbar](/organize/settings#navbar) for available options.
+
+
+ Whether to hide this language option by default.
+
+
Version switcher for sites with multiple [versions](/organize/navigation#versions).
From e6d1317f46bcfcbc793681466f109a8d4592ef9a Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Mon, 9 Mar 2026 15:57:50 -0700
Subject: [PATCH 2/4] Improve i18n guide prose for localized footer/navbar
section
- Replace passive intro with action-oriented opening
- Add explicit instruction to add footer/navbar to language config
- Tighten closing sentence on inheritance behavior
- Add banner mention for parity
Co-Authored-By: Claude Sonnet 4.6
---
guides/internationalization.mdx | 8 ++++++--
1 file changed, 6 insertions(+), 2 deletions(-)
diff --git a/guides/internationalization.mdx b/guides/internationalization.mdx
index 11d3c6947..e76c4ddb4 100644
--- a/guides/internationalization.mdx
+++ b/guides/internationalization.mdx
@@ -197,7 +197,9 @@ To add global navigation elements that appear across all languages, configure th
### Localized footer and navbar
-Each language entry in the `languages` array can include its own `footer` and `navbar` configurations. This allows you to translate footer links, navbar labels, and call-to-action buttons for each language.
+Customize the footer and navbar for each language to display translated content and region-specific links.
+
+Add `footer` and `navbar` properties to each language configuration:
```json docs.json
{
@@ -264,7 +266,9 @@ Each language entry in the `languages` array can include its own `footer` and `n
}
```
-Language-specific footer and navbar configurations override the global settings defined at the root level of `docs.json`. If a language does not specify a `footer` or `navbar`, it inherits the global configuration.
+Language-specific `footer` and `navbar` override the global settings for that language. If a language doesn't define these properties, it inherits the global configuration.
+
+You can also configure a language-specific `banner` using the same pattern.
## Maintain translations
From 70736bbd3e6b70f44f78dde6e7f7fcdc17491192 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 10 Mar 2026 14:07:44 -0700
Subject: [PATCH 3/4] fix JSON example and language code
---
guides/internationalization.mdx | 16 +++++++++++++---
organize/settings.mdx | 2 +-
2 files changed, 14 insertions(+), 4 deletions(-)
diff --git a/guides/internationalization.mdx b/guides/internationalization.mdx
index e76c4ddb4..87614b094 100644
--- a/guides/internationalization.mdx
+++ b/guides/internationalization.mdx
@@ -37,7 +37,7 @@ Create a separate directory for each language using [ISO 639-1 language codes](h
- `ru` - Russian
- `sv` - Swedish
- `tr` - Turkish
-- `ua` - Ukrainian
+- `uk` - Ukrainian
- `uz` - Uzbek
- `vi` - Vietnamese
@@ -231,7 +231,12 @@ Add `footer` and `navbar` properties to each language configuration:
"href": "/en/quickstart"
}
},
- "groups": [...]
+ "groups": [
+ {
+ "group": "Getting started",
+ "pages": ["en/quickstart", "en/index"]
+ }
+ ]
},
{
"language": "es",
@@ -259,7 +264,12 @@ Add `footer` and `navbar` properties to each language configuration:
"href": "/es/quickstart"
}
},
- "groups": [...]
+ "groups": [
+ {
+ "group": "Comenzando",
+ "pages": ["es/quickstart", "es/index"]
+ }
+ ]
}
]
}
diff --git a/organize/settings.mdx b/organize/settings.mdx
index 9ee823e2b..674356b5e 100644
--- a/organize/settings.mdx
+++ b/organize/settings.mdx
@@ -535,7 +535,7 @@ This section contains the full reference for the `docs.json` file.
Language switcher for [multi-language](/organize/navigation#languages) sites. Each language entry can include language-specific `banner`, `footer`, and `navbar` configurations in addition to the navigation structure.
-
+
Language code in ISO 639-1 format.
From f66a1d27b070f8b4d723da0633d96080c1b3534a Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 10 Mar 2026 14:17:21 -0700
Subject: [PATCH 4/4] fix links
---
organize/settings.mdx | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/organize/settings.mdx b/organize/settings.mdx
index 674356b5e..837d6bca3 100644
--- a/organize/settings.mdx
+++ b/organize/settings.mdx
@@ -542,13 +542,13 @@ This section contains the full reference for the `docs.json` file.
Whether this is the default language.
- Language-specific banner configuration. See [banner](/organize/settings#banner) for available options.
+ Language-specific banner configuration. See [banner](#param-banner-1) for available options.
- Language-specific footer configuration. See [footer](/organize/settings#footer) for available options.
+ Language-specific footer configuration. See [footer](#param-footer-1) for available options.
- Language-specific navbar configuration. See [navbar](/organize/settings#navbar) for available options.
+ Language-specific navbar configuration. See [navbar](#param-navbar-1) for available options.
Whether to hide this language option by default.