From 334ec3ccdb24648525c50a42a34167e8b79acd11 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 5 Aug 2026 07:07:55 +0000 Subject: [PATCH 1/6] docs: document static export HTML URLs --- api/static-export/overview.mdx | 12 ++++++++++++ es/api/static-export/overview.mdx | 15 +++++++++++++++ fr/api/static-export/overview.mdx | 12 ++++++++++++ zh/api/static-export/overview.mdx | 10 ++++++++++ 4 files changed, 49 insertions(+) diff --git a/api/static-export/overview.mdx b/api/static-export/overview.mdx index ca6f49497f..c662c2c764 100644 --- a/api/static-export/overview.mdx +++ b/api/static-export/overview.mdx @@ -10,6 +10,18 @@ keywords: ["static export", "static site", "bundle", "self-host", "enterprise"] Use the static export API to programmatically pre-render your site into a self-contained set of static files and download the result as a single bundle. The exported bundle is pure HTML, CSS, and JavaScript with no runtime dependencies, so you can host it on any static file storage or CDN. +## Page URLs in static bundles + +Static export bundles use explicit `.html` page URLs. For example, `/guides/getting-started` becomes `/guides/getting-started.html`, and the home page becomes `/index.html`. + +This format matches bundle files and supports S3 or plain static hosting without extensionless URL rewrites. Preserve `.html` filenames when you upload the bundle. The Static Export API enables this format automatically, so you do not need to change your documentation configuration. + +CloudFront deployments preserve client-side navigation and prefetching. Plain file hosts support full-page navigation through generated `.html` links. Cloud-hosted production sites remain unchanged. + + + Canonical and sitemap URLs remain extensionless. Custom client-side navigation URLs can also remain extensionless. CloudFront-backed deployments resolve them, while file-only hosts may need rewrites. + + ## How static export works A static export runs as an asynchronous job. You start the job, poll for its status, and then generate a downloadable bundle once the job completes. diff --git a/es/api/static-export/overview.mdx b/es/api/static-export/overview.mdx index 65cea41b74..9310bb60fa 100644 --- a/es/api/static-export/overview.mdx +++ b/es/api/static-export/overview.mdx @@ -10,6 +10,21 @@ keywords: ["static export", "static site", "bundle", "self-host", "enterprise"] Usa la API de exportación estática para prerenderizar tu sitio de forma programática en un conjunto autocontenido de archivos estáticos y descargar el resultado como un único paquete. El paquete exportado es HTML, CSS y JavaScript puros, sin dependencias en tiempo de ejecución, por lo que puedes alojarlo en cualquier almacenamiento de archivos estáticos o CDN. +## URLs en paquetes estáticos + +Los paquetes de exportación estática usan URLs de página explícitas con la extensión `.html`. +La exportación convierte `/guides/getting-started` en `/guides/getting-started.html`. +La exportación convierte la página de inicio en `/index.html`. +Este formato coincide con los archivos del paquete y permite alojarlos en S3 o en un hosting estático sencillo, sin reescrituras para URLs sin extensión. +Conserva los nombres de archivo `.html` al subirlos. La API de exportación estática habilita este formato automáticamente, por lo que no necesitas cambiar la configuración de tu documentación. +Los despliegues con CloudFront conservan la navegación del lado del cliente y la precarga. +Los servidores que solo sirven archivos permiten la navegación de página completa mediante los enlaces `.html` generados. +Los sitios de producción alojados en la nube siguen sin cambios. + + + Las URL canónicas y las del sitemap siguen sin extensión. Las URL personalizadas de navegación del lado del cliente también pueden seguir sin extensión. Los despliegues con CloudFront las resuelven, pero los servidores que solo sirven archivos quizá necesiten reescrituras. + +
## Cómo funciona la exportación estática
diff --git a/fr/api/static-export/overview.mdx b/fr/api/static-export/overview.mdx index 6010def0f3..c7449ff302 100644 --- a/fr/api/static-export/overview.mdx +++ b/fr/api/static-export/overview.mdx @@ -10,6 +10,18 @@ keywords: ["static export", "static site", "bundle", "self-host", "enterprise"] Utilisez l'API d'exportation statique pour pré-rendre votre site par programmation en un ensemble autonome de fichiers statiques et télécharger le résultat sous forme d'un unique bundle. Le bundle exporté est composé de HTML, CSS et JavaScript purs, sans dépendances d'exécution, afin que vous puissiez l'héberger sur n'importe quel stockage de fichiers statiques ou CDN. +## URL des pages exportées + +Les bundles d’exportation statique utilisent des URL de pages explicites avec l’extension `.html`. Ainsi, `/guides/getting-started` devient `/guides/getting-started.html`, et la page d’accueil devient `/index.html`. + +Cette structure correspond aux fichiers du bundle et permet un hébergement S3 ou statique simple, sans nécessiter la réécriture d’URL sans extension. Conservez les noms de fichiers `.html` lors du téléversement. L’API d’exportation statique active automatiquement ce format, vous n’avez donc pas besoin de modifier la configuration de votre documentation. + +Les déploiements avec CloudFront préservent la navigation côté client et le préchargement des pages. Les hébergeurs de fichiers simples prennent en charge la navigation par pages complètes grâce aux liens `.html` générés. Les sites de production hébergés normalement dans le cloud restent inchangés. + + + Les URL canoniques et celles du sitemap restent sans extension. Vos URL personnalisées de navigation côté client peuvent également rester sans extension. Les déploiements reposant sur CloudFront les résolvent, mais les hébergeurs qui servent uniquement des fichiers peuvent nécessiter des réécritures. + +
## Fonctionnement de l'exportation statique
diff --git a/zh/api/static-export/overview.mdx b/zh/api/static-export/overview.mdx index 4cbe17dd5f..88a0afc54b 100644 --- a/zh/api/static-export/overview.mdx +++ b/zh/api/static-export/overview.mdx @@ -10,6 +10,16 @@ keywords: ["static export", "static site", "bundle", "self-host", "enterprise"] 使用静态导出 API 以编程方式将站点预渲染为一组自包含的静态文件，并将结果作为单个包下载。导出的包为纯 HTML、CSS 和 JavaScript，没有运行时依赖，因此你可以将其托管在任何静态文件存储或 CDN 上。 +## 页面 URL 与托管方式 + +静态导出包使用明确的 `.html` 页面 URL。`/guides/getting-started` 会变为 `/guides/getting-started.html`，首页则为 `/index.html`。这样 URL 与包中的文件相对应，可以直接部署到 S3 或普通静态托管，无需将无扩展名 URL 重写为文件路径。上传时请保留 `.html` 文件名。静态导出 API 会自动启用此格式，因此你无需修改文档配置。 + +部署到 CloudFront 时，客户端导航和预取仍可正常工作。仅支持文件访问的托管服务则通过生成的 `.html` 链接支持整页导航。普通云托管生产站点不受影响。 + + + canonical 和 sitemap 中的 URL 仍保持无扩展名；自定义的客户端导航 URL 也可以继续使用无扩展名。CloudFront 部署会解析这些 URL，但仅提供文件的托管服务可能需要配置重写。 + +
## 静态导出的工作原理
From ac1abc16b2ee1f159047e3b26ffb7e4915d4efb4 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 5 Aug 2026 07:10:33 +0000 Subject: [PATCH 2/6] docs: polish static export translations --- es/api/static-export/overview.mdx | 4 +++- fr/api/static-export/overview.mdx | 6 ++++-- zh/api/static-export/overview.mdx | 6 ++++-- 3 files changed, 11 insertions(+), 5 deletions(-) diff --git a/es/api/static-export/overview.mdx b/es/api/static-export/overview.mdx index 9310bb60fa..eb4ec81220 100644 --- a/es/api/static-export/overview.mdx +++ b/es/api/static-export/overview.mdx @@ -10,7 +10,9 @@ keywords: ["static export", "static site", "bundle", "self-host", "enterprise"] Usa la API de exportación estática para prerenderizar tu sitio de forma programática en un conjunto autocontenido de archivos estáticos y descargar el resultado como un único paquete. El paquete exportado es HTML, CSS y JavaScript puros, sin dependencias en tiempo de ejecución, por lo que puedes alojarlo en cualquier almacenamiento de archivos estáticos o CDN. -## URLs en paquetes estáticos +
+ ## URLs en paquetes estáticos +
Los paquetes de exportación estática usan URLs de página explícitas con la extensión `.html`. La exportación convierte `/guides/getting-started` en `/guides/getting-started.html`. diff --git a/fr/api/static-export/overview.mdx b/fr/api/static-export/overview.mdx index c7449ff302..0d025b6a31 100644 --- a/fr/api/static-export/overview.mdx +++ b/fr/api/static-export/overview.mdx @@ -10,11 +10,13 @@ keywords: ["static export", "static site", "bundle", "self-host", "enterprise"] Utilisez l'API d'exportation statique pour pré-rendre votre site par programmation en un ensemble autonome de fichiers statiques et télécharger le résultat sous forme d'un unique bundle. Le bundle exporté est composé de HTML, CSS et JavaScript purs, sans dépendances d'exécution, afin que vous puissiez l'héberger sur n'importe quel stockage de fichiers statiques ou CDN. -## URL des pages exportées +
+ ## URL des pages exportées +
Les bundles d’exportation statique utilisent des URL de pages explicites avec l’extension `.html`. Ainsi, `/guides/getting-started` devient `/guides/getting-started.html`, et la page d’accueil devient `/index.html`. -Cette structure correspond aux fichiers du bundle et permet un hébergement S3 ou statique simple, sans nécessiter la réécriture d’URL sans extension. Conservez les noms de fichiers `.html` lors du téléversement. L’API d’exportation statique active automatiquement ce format, vous n’avez donc pas besoin de modifier la configuration de votre documentation. +Cette structure correspond aux fichiers du bundle. Elle permet un hébergement S3 ou statique simple, sans nécessiter la réécriture d’URL sans extension. Conservez les noms de fichiers `.html` lors du téléversement. L’API d’exportation statique active automatiquement ce format, vous n’avez donc pas besoin de modifier la configuration de votre documentation. Les déploiements avec CloudFront préservent la navigation côté client et le préchargement des pages. Les hébergeurs de fichiers simples prennent en charge la navigation par pages complètes grâce aux liens `.html` générés. Les sites de production hébergés normalement dans le cloud restent inchangés. diff --git a/zh/api/static-export/overview.mdx b/zh/api/static-export/overview.mdx index 88a0afc54b..95d75d114a 100644 --- a/zh/api/static-export/overview.mdx +++ b/zh/api/static-export/overview.mdx @@ -1,6 +1,6 @@ --- title: "静态导出" -description: "通过 Mintlify REST API 生成自包含的文档静态导出，并以单个包的形式下载。" +description: "通过 Mintlify REST API 生成自包含的文档静态导出，并以单个包的形式下载。了解如何预渲染文档、部署静态文件，并在 S3、CDN 或其他静态托管服务上托管。" keywords: ["static export", "static site", "bundle", "self-host", "enterprise"] --- @@ -10,7 +10,9 @@ keywords: ["static export", "static site", "bundle", "self-host", "enterprise"] 使用静态导出 API 以编程方式将站点预渲染为一组自包含的静态文件，并将结果作为单个包下载。导出的包为纯 HTML、CSS 和 JavaScript，没有运行时依赖，因此你可以将其托管在任何静态文件存储或 CDN 上。 -## 页面 URL 与托管方式 +
+ ## 页面 URL 与托管方式 +
静态导出包使用明确的 `.html` 页面 URL。`/guides/getting-started` 会变为 `/guides/getting-started.html`，首页则为 `/index.html`。这样 URL 与包中的文件相对应，可以直接部署到 S3 或普通静态托管，无需将无扩展名 URL 重写为文件路径。上传时请保留 `.html` 文件名。静态导出 API 会自动启用此格式，因此你无需修改文档配置。 From ba4735a79c52f28798501766a884c9244543512b Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 5 Aug 2026 11:07:12 +0000 Subject: [PATCH 3/6] docs: cover imperative static export navigation --- api/static-export/overview.mdx | 2 ++ es/api/static-export/overview.mdx | 2 ++ fr/api/static-export/overview.mdx | 2 ++ zh/api/static-export/overview.mdx | 2 ++ 4 files changed, 8 insertions(+) diff --git a/api/static-export/overview.mdx b/api/static-export/overview.mdx index c662c2c764..42a1ac6a86 100644 --- a/api/static-export/overview.mdx +++ b/api/static-export/overview.mdx @@ -18,6 +18,8 @@ This format matches bundle files and supports S3 or plain static hosting without CloudFront deployments preserve client-side navigation and prefetching. Plain file hosts support full-page navigation through generated `.html` links. Cloud-hosted production sites remain unchanged. +Built-in controls that navigate internally, such as version and language switchers, search results, cards, assistant citations, and API playground links, also use `.html` destinations. Query strings remain intact, so API playground links continue to work. + Canonical and sitemap URLs remain extensionless. Custom client-side navigation URLs can also remain extensionless. CloudFront-backed deployments resolve them, while file-only hosts may need rewrites. diff --git a/es/api/static-export/overview.mdx b/es/api/static-export/overview.mdx index eb4ec81220..cb17a462e8 100644 --- a/es/api/static-export/overview.mdx +++ b/es/api/static-export/overview.mdx @@ -23,6 +23,8 @@ Los despliegues con CloudFront conservan la navegación del lado del cliente y l Los servidores que solo sirven archivos permiten la navegación de página completa mediante los enlaces `.html` generados. Los sitios de producción alojados en la nube siguen sin cambios. +Los controles integrados utilizan también destinos `.html` para la navegación interna. Esto incluye los selectores de versión e idioma, los resultados de búsqueda, las tarjetas, las citas del asistente y los enlaces del playground de API. Las cadenas de consulta se conservan, por lo que los enlaces del playground de API siguen funcionando. + Las URL canónicas y las del sitemap siguen sin extensión. Las URL personalizadas de navegación del lado del cliente también pueden seguir sin extensión. Los despliegues con CloudFront las resuelven, pero los servidores que solo sirven archivos quizá necesiten reescrituras. diff --git a/fr/api/static-export/overview.mdx b/fr/api/static-export/overview.mdx index 0d025b6a31..17f3411c0c 100644 --- a/fr/api/static-export/overview.mdx +++ b/fr/api/static-export/overview.mdx @@ -20,6 +20,8 @@ Cette structure correspond aux fichiers du bundle. Elle permet un hébergement S Les déploiements avec CloudFront préservent la navigation côté client et le préchargement des pages. Les hébergeurs de fichiers simples prennent en charge la navigation par pages complètes grâce aux liens `.html` générés. Les sites de production hébergés normalement dans le cloud restent inchangés. +Les contrôles intégrés utilisent également des destinations en `.html` pour la navigation interne. Cela concerne notamment les sélecteurs de version et de langue, les résultats de recherche, les cartes, les citations de l’assistant et les liens du playground d’API. Les chaînes de requête sont conservées, les liens du playground d’API continuent donc de fonctionner. + Les URL canoniques et celles du sitemap restent sans extension. Vos URL personnalisées de navigation côté client peuvent également rester sans extension. Les déploiements reposant sur CloudFront les résolvent, mais les hébergeurs qui servent uniquement des fichiers peuvent nécessiter des réécritures. diff --git a/zh/api/static-export/overview.mdx b/zh/api/static-export/overview.mdx index 95d75d114a..b4b130faca 100644 --- a/zh/api/static-export/overview.mdx +++ b/zh/api/static-export/overview.mdx @@ -18,6 +18,8 @@ keywords: ["static export", "static site", "bundle", "self-host", "enterprise"] 部署到 CloudFront 时，客户端导航和预取仍可正常工作。仅支持文件访问的托管服务则通过生成的 `.html` 链接支持整页导航。普通云托管生产站点不受影响。 +内置控件在进行内部导航时也会使用 `.html` 目标地址，包括版本和语言切换器、搜索结果、卡片、助手引用及 API playground 链接。查询字符串会保留，因此 API playground 链接仍可正常工作。 + canonical 和 sitemap 中的 URL 仍保持无扩展名；自定义的客户端导航 URL 也可以继续使用无扩展名。CloudFront 部署会解析这些 URL，但仅提供文件的托管服务可能需要配置重写。 From 50751feb9bf473db562f5e912ae190c6e1b250d8 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 5 Aug 2026 11:10:33 +0000 Subject: [PATCH 4/6] docs: polish static export overview pages --- api/static-export/overview.mdx | 4 ++-- es/api/static-export/overview.mdx | 2 +- fr/api/static-export/overview.mdx | 2 +- zh/api/static-export/overview.mdx | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/api/static-export/overview.mdx b/api/static-export/overview.mdx index 42a1ac6a86..378d3f7b41 100644 --- a/api/static-export/overview.mdx +++ b/api/static-export/overview.mdx @@ -14,11 +14,11 @@ Use the static export API to programmatically pre-render your site into a self-c Static export bundles use explicit `.html` page URLs. For example, `/guides/getting-started` becomes `/guides/getting-started.html`, and the home page becomes `/index.html`. -This format matches bundle files and supports S3 or plain static hosting without extensionless URL rewrites. Preserve `.html` filenames when you upload the bundle. The Static Export API enables this format automatically, so you do not need to change your documentation configuration. +This format matches the files in the bundle and supports S3 or plain static hosting without extensionless URL rewrites. Preserve `.html` filenames when you upload the bundle. The Static Export API enables this format automatically, so you do not need to change your documentation configuration. CloudFront deployments preserve client-side navigation and prefetching. Plain file hosts support full-page navigation through generated `.html` links. Cloud-hosted production sites remain unchanged. -Built-in controls that navigate internally, such as version and language switchers, search results, cards, assistant citations, and API playground links, also use `.html` destinations. Query strings remain intact, so API playground links continue to work. +Built-in internal navigation, including version and language switchers, search results, cards, assistant citations, and API playground links, also uses `.html` destinations. Query strings remain intact, so API playground links continue to work. Canonical and sitemap URLs remain extensionless. Custom client-side navigation URLs can also remain extensionless. CloudFront-backed deployments resolve them, while file-only hosts may need rewrites. diff --git a/es/api/static-export/overview.mdx b/es/api/static-export/overview.mdx index cb17a462e8..0851d0a143 100644 --- a/es/api/static-export/overview.mdx +++ b/es/api/static-export/overview.mdx @@ -23,7 +23,7 @@ Los despliegues con CloudFront conservan la navegación del lado del cliente y l Los servidores que solo sirven archivos permiten la navegación de página completa mediante los enlaces `.html` generados. Los sitios de producción alojados en la nube siguen sin cambios. -Los controles integrados utilizan también destinos `.html` para la navegación interna. Esto incluye los selectores de versión e idioma, los resultados de búsqueda, las tarjetas, las citas del asistente y los enlaces del playground de API. Las cadenas de consulta se conservan, por lo que los enlaces del playground de API siguen funcionando. +La navegación interna integrada también utiliza destinos `.html`. Esto incluye los selectores de versión e idioma, los resultados de búsqueda, las tarjetas, las citas del asistente y los enlaces del playground de API. Las cadenas de consulta se conservan, por lo que los enlaces del playground de API siguen funcionando. Las URL canónicas y las del sitemap siguen sin extensión. Las URL personalizadas de navegación del lado del cliente también pueden seguir sin extensión. Los despliegues con CloudFront las resuelven, pero los servidores que solo sirven archivos quizá necesiten reescrituras. diff --git a/fr/api/static-export/overview.mdx b/fr/api/static-export/overview.mdx index 17f3411c0c..12988cd2b5 100644 --- a/fr/api/static-export/overview.mdx +++ b/fr/api/static-export/overview.mdx @@ -20,7 +20,7 @@ Cette structure correspond aux fichiers du bundle. Elle permet un hébergement S Les déploiements avec CloudFront préservent la navigation côté client et le préchargement des pages. Les hébergeurs de fichiers simples prennent en charge la navigation par pages complètes grâce aux liens `.html` générés. Les sites de production hébergés normalement dans le cloud restent inchangés. -Les contrôles intégrés utilisent également des destinations en `.html` pour la navigation interne. Cela concerne notamment les sélecteurs de version et de langue, les résultats de recherche, les cartes, les citations de l’assistant et les liens du playground d’API. Les chaînes de requête sont conservées, les liens du playground d’API continuent donc de fonctionner. +La navigation interne intégrée utilise également des destinations en `.html`. Cela concerne notamment les sélecteurs de version et de langue, les résultats de recherche, les cartes, les citations de l’assistant et les liens du playground d’API. Les chaînes de requête sont conservées. Les liens du playground d’API continuent donc de fonctionner. Les URL canoniques et celles du sitemap restent sans extension. Vos URL personnalisées de navigation côté client peuvent également rester sans extension. Les déploiements reposant sur CloudFront les résolvent, mais les hébergeurs qui servent uniquement des fichiers peuvent nécessiter des réécritures. diff --git a/zh/api/static-export/overview.mdx b/zh/api/static-export/overview.mdx index b4b130faca..ac898f386d 100644 --- a/zh/api/static-export/overview.mdx +++ b/zh/api/static-export/overview.mdx @@ -11,7 +11,7 @@ keywords: ["static export", "static site", "bundle", "self-host", "enterprise"] 使用静态导出 API 以编程方式将站点预渲染为一组自包含的静态文件，并将结果作为单个包下载。导出的包为纯 HTML、CSS 和 JavaScript，没有运行时依赖，因此你可以将其托管在任何静态文件存储或 CDN 上。
- ## 页面 URL 与托管方式 + ## 静态导出包中的页面 URL
静态导出包使用明确的 `.html` 页面 URL。`/guides/getting-started` 会变为 `/guides/getting-started.html`，首页则为 `/index.html`。这样 URL 与包中的文件相对应，可以直接部署到 S3 或普通静态托管，无需将无扩展名 URL 重写为文件路径。上传时请保留 `.html` 文件名。静态导出 API 会自动启用此格式，因此你无需修改文档配置。 From e7ee5a45befd30e15b7584e84e20be2f8fd8accc Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Mon, 10 Aug 2026 14:21:58 -0700 Subject: [PATCH 5/6] Apply suggestion from @ethanpalm --- api/static-export/overview.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/static-export/overview.mdx b/api/static-export/overview.mdx index 378d3f7b41..e8c63cab6d 100644 --- a/api/static-export/overview.mdx +++ b/api/static-export/overview.mdx @@ -12,7 +12,7 @@ Use the static export API to programmatically pre-render your site into a self-c ## Page URLs in static bundles -Static export bundles use explicit `.html` page URLs. For example, `/guides/getting-started` becomes `/guides/getting-started.html`, and the home page becomes `/index.html`. +Static export bundles use explicit `.html` page URLs. For example, `/guides/getting-started` becomes `/guides/getting-started.html`. This format matches the files in the bundle and supports S3 or plain static hosting without extensionless URL rewrites. Preserve `.html` filenames when you upload the bundle. The Static Export API enables this format automatically, so you do not need to change your documentation configuration. From 018a27874e9f1964a6effd2f13761a37276f0edf Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Mon, 10 Aug 2026 14:31:06 -0700 Subject: [PATCH 6/6] Apply suggestion from @ethanpalm --- api/static-export/overview.mdx | 10 ++-------- 1 file changed, 2 insertions(+), 8 deletions(-) diff --git a/api/static-export/overview.mdx b/api/static-export/overview.mdx index e8c63cab6d..685a500146 100644 --- a/api/static-export/overview.mdx +++ b/api/static-export/overview.mdx @@ -12,16 +12,10 @@ Use the static export API to programmatically pre-render your site into a self-c ## Page URLs in static bundles -Static export bundles use explicit `.html` page URLs. For example, `/guides/getting-started` becomes `/guides/getting-started.html`. - -This format matches the files in the bundle and supports S3 or plain static hosting without extensionless URL rewrites. Preserve `.html` filenames when you upload the bundle. The Static Export API enables this format automatically, so you do not need to change your documentation configuration. - -CloudFront deployments preserve client-side navigation and prefetching. Plain file hosts support full-page navigation through generated `.html` links. Cloud-hosted production sites remain unchanged. - -Built-in internal navigation, including version and language switchers, search results, cards, assistant citations, and API playground links, also uses `.html` destinations. Query strings remain intact, so API playground links continue to work. +Static exports use `.html` URLs that match the files in the bundle. For example, `/guides/getting-started` becomes `/guides/getting-started.html`. This happens automatically and requires no configuration. - Canonical and sitemap URLs remain extensionless. Custom client-side navigation URLs can also remain extensionless. CloudFront-backed deployments resolve them, while file-only hosts may need rewrites. + Canonical and sitemap URLs remain extensionless. CloudFront resolves these URLs automatically, but other static hosts may require rewrite rules. ## How static export works