Paramètres globaux

Le fichier docs.json vous permet de transformer une collection de fichiers Markdown en un site de documentation navigable et personnalisable. Ce fichier de configuration obligatoire contrôle le style, la navigation, les intégrations, et bien plus encore. Considérez-le comme le plan de votre documentation. Les paramètres de docs.json s’appliquent globalement à toutes les pages.

Configuration de votre `docs.json`

Pour commencer, vous n’avez besoin d’indiquer que theme, name, colors.primary et navigation. Les autres champs sont facultatifs et vous pourrez les ajouter à mesure que vos besoins en documentation évoluent. Pour une expérience d’édition optimale, ajoutez la référence de schéma en haut de votre fichier docs.json. Cela active l’autocomplétion, la validation et des info-bulles utiles dans la plupart des éditeurs de code :

{
  "$schema": "https://mintlify.com/docs.json",
  "theme": "mint",
  "name": "Vos docs",
  "colors": {
    "primary": "#ff0000"
  },
  "navigation": {
    // Votre structure de navigation
  }
  // Le reste de votre configuration
}

Référence

Cette section contient la référence complète du fichier docs.json.

Personnalisation

requis

Le thème de mise en page de votre site.L’un des suivants : mint, maple, palm, willow, linden, almond, aspen.Voir Thèmes pour plus d’informations.

string

requis

Le nom de votre projet, de votre organisation ou de votre produit.

object

requis

Les couleurs utilisées dans votre documentation. Leur application varie selon le thème. Si vous ne fournissez qu’une couleur principale, elle sera utilisée pour tous les éléments colorés.

Afficher Couleurs

string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$

requis

La couleur principale de votre documentation. Généralement utilisée pour la mise en avant en mode clair, avec quelques variations selon le thème.Doit être un code hexadécimal commençant par #.

string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$

La couleur utilisée pour la mise en avant en mode sombre.Doit être un code hexadécimal commençant par #.

string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$

La couleur utilisée pour les boutons et les états au survol en modes clair et sombre, avec quelques variations selon le thème.Doit être un code hexadécimal commençant par #.

string

Description de votre site pour le référencement (SEO) et l’indexation par l’IA.

string or object

Votre logo pour les modes clair et sombre.

Afficher Logo

string

requis

Chemin vers le fichier de votre logo pour le mode clair. Incluez l’extension du fichier. Exemple : /logo.png

string

requis

Chemin vers le fichier de votre logo pour le mode sombre. Incluez l’extension du fichier. Exemple : /logo-dark.png

string (uri)

L’URL vers laquelle rediriger lorsqu’on clique sur le logo. Si elle n’est pas fournie, le logo renverra vers votre page d’accueil. Exemple : https://mintlify.com

string or object

Chemin vers votre fichier favicon, incluant l’extension. Redimensionné automatiquement aux tailles de favicon appropriées. Peut être un fichier unique ou des fichiers distincts pour les modes clair et sombre. Exemple : /favicon.png

Afficher Favicon

string

requis

Chemin vers votre fichier favicon pour le mode clair. Incluez l’extension du fichier. Exemple : /favicon.png

string

requis

Chemin vers votre fichier favicon pour le mode sombre. Incluez l’extension du fichier. Exemple : /favicon-dark.png

object

Personnalisation des vignettes pour les réseaux sociaux et les aperçus de page.

Afficher Vignettes

"light" | "dark"

Le thème visuel de vos vignettes. S’il n’est pas spécifié, les vignettes utilisent la palette de couleurs de votre site définie par le champ colors.

string

Image d’arrière-plan pour vos vignettes. Peut être un chemin relatif ou une URL absolue.

object

Configuration du style visuel.

Afficher Styling

"section" | "breadcrumbs"

Style de l’eyebrow de page. Choisissez section pour afficher le nom de la section ou breadcrumbs pour afficher le chemin de navigation complet. Par défaut : section.

"system" | "dark" | object

Configuration du thème des blocs de code. Par défaut : "system".Options simples :

"system" : faire correspondre le mode actuel du site (clair ou sombre)
"dark" : utiliser toujours le mode sombre

Configuration de thème personnalisée : Utilisez un objet pour spécifier des thèmes Shiki. Choisissez un seul thème pour les deux modes ou des thèmes distincts pour les modes clair et sombre.

Afficher codeblocks

string

Un nom de thème Shiki unique à utiliser pour les modes clair et sombre.

"styling": {
  "codeblocks": {
    "theme": "dracula"
  }
}

object

Thèmes distincts pour les modes clair et sombre.

Afficher themes

string

requis

Un nom de thème Shiki pour le mode clair.

string

requis

Un nom de thème Shiki pour le mode sombre.

"styling": {
  "codeblocks": {
    "themes": {
      "light": "github-light",
      "dark": "github-dark"
    }
  }
}

object

Paramètres de la bibliothèque d’icônes.

Afficher Icons

"fontawesome" | "lucide"

requis

Bibliothèque d’icônes à utiliser dans l’ensemble de votre documentation. Par défaut : fontawesome.

Vous pouvez spécifier une URL vers une icône hébergée en externe, un chemin vers un fichier d’icône dans votre projet, ou du code SVG compatible JSX pour n’importe quelle icône individuelle, quel que soit le paramètre de bibliothèque.

object

Configuration des polices pour votre documentation. La police par défaut est Inter.

Afficher Fonts

string

requis

Famille de polices, par exemple « Open Sans », « Playfair Display ».

number

Graisse de police, par exemple 400 ou 700. Les polices variables prennent en charge des graisses précises comme 550.

string (uri)

URL de la source de votre police, par exemple https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2. Google Fonts est chargé automatiquement lorsque vous spécifiez un nom de family Google Fonts, donc aucune URL source n’est nécessaire.

"woff" | "woff2"

Format du fichier de police.

object

Remplace les paramètres de police spécifiquement pour les titres.

Afficher Heading

string

requis

Famille de polices, par exemple « Open Sans », « Playfair Display ».

number

Graisse de police, par exemple 400 ou 700. Les polices variables prennent en charge des graisses précises comme 550.

string (uri)

"woff" | "woff2"

Format du fichier de police.

object

Remplace les paramètres de police spécifiquement pour le corps de texte.

Afficher Body

string

requis

Famille de polices, par exemple « Open Sans », « Playfair Display ».

number

Graisse de police, par exemple 400 ou 700. Les polices variables prennent en charge des graisses précises comme 550.

string (uri)

"woff" | "woff2"

Format du fichier de police.

object

Paramètres de l’interrupteur de mode clair/sombre.

Afficher Appearance

"system" | "light" | "dark"

Mode de thème par défaut. Choisissez system pour s’aligner sur les paramètres du système d’exploitation de l’utilisateur, ou light/dark pour imposer un mode spécifique. Par défaut : system.

boolean

Indique s’il faut masquer l’interrupteur clair/sombre. Par défaut : true.

object

Paramètres de couleur et de décoration d’arrière-plan.

Afficher Background

string or object

Image d’arrière-plan pour votre site. Peut être un fichier unique ou des fichiers distincts pour les modes clair et sombre.

Afficher Image

string

requis

Chemin vers votre image d’arrière-plan pour le mode clair. Incluez l’extension du fichier. Exemple : /background.png.

string

requis

Chemin vers votre image d’arrière-plan pour le mode sombre. Incluez l’extension du fichier. Exemple : /background-dark.png.

"gradient" | "grid" | "windows"

Décoration d’arrière-plan pour votre thème.

object

Couleurs d’arrière-plan personnalisées pour les modes clair et sombre.

Afficher Color

string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$

Couleur d’arrière-plan pour le mode clair.Doit être un code hexadécimal commençant par #.

string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$

Couleur d’arrière-plan pour le mode sombre.Doit être un code hexadécimal commençant par #.

Structure

Éléments de la barre de navigation.

Afficher Navbar

array of object

Liens à afficher dans la barre de navigation.

Afficher Links

string

requis

Texte du lien.

string (uri)

requis

URL ou chemin de destination du lien.

string

L’icône à afficher.Options :

Nom d’icône Font Awesome
Nom d’icône Lucide
Code SVG compatible JSX entre accolades
URL d’une icône hébergée en externe
Chemin vers un fichier d’icône dans votre projet

Pour des icônes SVG personnalisées :

Convertissez votre SVG avec le convertisseur SVGR.
Collez votre code SVG dans le champ de saisie SVG.
Copiez l’élément complet <svg>...</svg> depuis le champ de sortie JSX.
Mettez le code SVG compatible JSX entre accolades : icon={<svg ...> ... </svg>}.
Ajustez height et width au besoin.

string

Le style d’icône Font Awesome. Utilisé uniquement avec les icônes Font Awesome.Options : regular, solid, light, thin, sharp-solid, duotone, brands.

object

Bouton principal de la barre de navigation.

Afficher Primary

"button" | "github"

requis

Style du bouton. Choisissez button pour un bouton standard avec libellé, ou github pour un lien vers un dépôt GitHub avec icône.

string

requis

Texte du bouton. S’applique uniquement lorsque type vaut button.

string (uri)

requis

Destination du bouton. Doit être un chemin valide ou une URL externe. Si type est github, il doit s’agir de l’URL d’un dépôt GitHub.

La structure de navigation de votre contenu.

Afficher Navigation

object

Éléments de navigation globaux qui apparaissent sur l’ensemble des pages et sections.

Afficher Global

array of object

Configuration du sélecteur de langue pour les sites localisés.

Afficher Langues

"en" | "cn" | "zh" | "zh-Hans" | "zh-Hant" | "es" | "fr" | "ja" | "jp" | "pt" | "pt-BR" | "de" | "ko" | "it" | "ru" | "id" | "ar" | "tr"

requis

Code de langue au format ISO 639-1

boolean

Indique s’il s’agit de la langue par défaut.

boolean

Indique s’il faut masquer cette langue par défaut.

string (uri)

requis

Un chemin ou un lien externe valide vers cette version linguistique de votre documentation.

array of object

Configuration du sélecteur de versions pour les sites multi‑versions.

Afficher Versions

string

requis

Nom affiché de la version.Longueur minimale : 1

boolean

Indique s’il s’agit de la version par défaut.

boolean

Indique s’il faut masquer cette option de version par défaut.

string (uri)

requis

URL ou chemin vers cette version de votre documentation.

array of object

Onglets de navigation de premier niveau pour organiser les sections principales.

Afficher Tabs

string

requis

Nom affiché de l’onglet.Longueur minimale : 1

string

L’icône à afficher.Options :

Nom d’icône Font Awesome
Nom d’icône Lucide
Code SVG compatible JSX entre accolades
URL d’une icône hébergée en externe
Chemin vers un fichier d’icône dans votre projet

Pour des icônes SVG personnalisées :

Convertissez votre SVG avec le convertisseur SVGR.
Collez votre code SVG dans le champ de saisie SVG.
Copiez l’élément complet <svg>...</svg> depuis le champ de sortie JSX.
Mettez le code SVG compatible JSX entre accolades : icon={<svg ...> ... </svg>}.
Ajustez height et width au besoin.

string

Le style d’icône Font Awesome. Utilisé uniquement avec les icônes Font Awesome.Options : regular, solid, light, thin, sharp-solid, duotone, brands.

boolean

Indique s’il faut masquer cet onglet par défaut.

string (uri)

requis

URL ou chemin de destination de l’onglet.

array of object

Liens d’ancrage qui apparaissent en évidence dans la navigation de la barre latérale.

Afficher Ancres

string

requis

Nom affiché de l’ancre.Longueur minimale : 1

string

L’icône à afficher.Options :

Nom d’icône Font Awesome
Nom d’icône Lucide
Code SVG compatible JSX entre accolades
URL d’une icône hébergée en externe
Chemin vers un fichier d’icône dans votre projet

Pour des icônes SVG personnalisées :

Convertissez votre SVG avec le convertisseur SVGR.
Collez votre code SVG dans le champ de saisie SVG.
Copiez l’élément complet <svg>...</svg> depuis le champ de sortie JSX.
Mettez le code SVG compatible JSX entre accolades : icon={<svg ...> ... </svg>}.
Ajustez height et width au besoin.

string

Le style d’icône Font Awesome. Utilisé uniquement avec les icônes Font Awesome.Options : regular, solid, light, thin, sharp-solid, duotone, brands.

object

Couleurs personnalisées de l’ancre.

Afficher Couleur

string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$

Couleur de l’ancre en mode clair.Doit être un code hexadécimal commençant par #.

string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$

Couleur de l’ancre en mode sombre.Doit être un code hexadécimal commençant par #.

boolean

Indique si cette ancre est masquée par défaut.

string (uri)

requis

URL ou chemin de destination de l’ancre.

array of object

Menus déroulants pour organiser du contenu connexe.

Afficher Dropdowns

Nom affiché du menu déroulant.Longueur minimale : 1

string

L’icône à afficher.Options :

Nom d’icône Font Awesome
Nom d’icône Lucide
Code SVG compatible JSX entre accolades
URL d’une icône hébergée en externe
Chemin vers un fichier d’icône dans votre projet

Pour des icônes SVG personnalisées :

Convertissez votre SVG avec le convertisseur SVGR.
Collez votre code SVG dans le champ de saisie SVG.
Copiez l’élément complet <svg>...</svg> depuis le champ de sortie JSX.
Mettez le code SVG compatible JSX entre accolades : icon={<svg ...> ... </svg>}.
Ajustez height et width au besoin.

string

Le style d’icône Font Awesome. Utilisé uniquement avec les icônes Font Awesome.Options : regular, solid, light, thin, sharp-solid, duotone, brands.

boolean

Indique s’il faut masquer ce menu déroulant par défaut.

string (uri)

requis

URL ou chemin de destination du menu déroulant.

array of object

Sélecteur de langue pour les sites multilingues.

array of object

Sélecteur de versions pour les sites comportant plusieurs versions.

array of object

Navigation de niveau supérieur onglets.

array of object

Barre latérale : ancres.

array of object

Menus déroulants pour regrouper du contenu associé.

array of object

Groupes pour organiser le contenu en sections.

array of string or object

Pages individuelles qui constituent votre documentation.

object

Paramètres d’interaction utilisateur pour les éléments de navigation.

Afficher Interaction

boolean

Contrôle le comportement de navigation automatique lors de la sélection de groupes de navigation. Définissez sur true pour forcer la navigation vers la première page lorsqu’un groupe de navigation est développé. Définissez sur false pour empêcher la navigation et uniquement développer ou réduire le groupe. Laissez non défini pour utiliser le comportement par défaut du thème.

object

Contenu du pied de page et liens vers les réseaux sociaux.

Afficher Footer

object

Profils de réseaux sociaux à afficher dans le pied de page. Chaque clé est un nom de plateforme et chaque valeur est l’URL de votre profil. Par exemple :

{
  "x": "https://x.com/mintlify"
}

Noms de propriétés valides : x, website, facebook, youtube, discord, slack, github, linkedin, instagram, hacker-news, medium, telegram, twitter, x-twitter, earth-americas, bluesky, threads, reddit, podcast

array of object

Liens à afficher dans le pied de page.

Afficher Links

string

Titre de la colonne.Longueur minimale : 1

array of object

requis

Liens à afficher dans la colonne.

Afficher Items

string

requis

Texte du lien.Longueur minimale : 1

string (uri)

requis

URL de destination du lien.

object

Bannière globale du site affichée en haut des pages.

Afficher Banner

string

Contenu de la bannière. Prend en charge le texte brut et la mise en forme Markdown. Par exemple :

{
  "content": "🚀 Bannière en ligne ! [En savoir plus](mintlify.com)"
}

boolean

Indique si les utilisateurs peuvent fermer la bannière. Par défaut : false.

array of object

Redirections pour les pages déplacées, renommées ou supprimées.

Afficher Redirects

string

requis

Chemin source à partir duquel rediriger. Exemple : /old-page

string

requis

Chemin de destination vers lequel rediriger. Exemple : /new-page

boolean

Indique s’il faut utiliser une redirection permanente (301). Par défaut : true.

object

Menu contextuel pour le contenu optimisé par l’IA et les intégrations.

Afficher Contextual

requis

Actions disponibles dans le menu contextuel. La première option apparaît par défaut.

copy: Copier la page actuelle en Markdown dans le presse-papiers.
view: Afficher la page actuelle en Markdown dans un nouvel onglet.
chatgpt: Envoyer le contenu de la page actuelle à ChatGPT.
claude: Envoyer le contenu de la page actuelle à Claude.
perplexity: Envoyer le contenu de la page actuelle à Perplexity.
mcp: Copier l’URL de votre serveur MCP dans le presse-papiers.
cursor: Installer votre serveur MCP hébergé dans Cursor.
vscode: Installer votre serveur MCP hébergé dans VSCode.

Le menu contextuel est disponible uniquement sur les déploiements de prévisualisation et de production.

Configurations d’API

object

Paramètres de la documentation API et du terrain de jeu interactif.

Afficher Api

string or array or object

Fichiers de spécification OpenAPI pour générer la documentation API. Peut être une seule URL/un seul chemin ou un tableau d’URL/de chemins.

Afficher Openapi

string

URL ou chemin vers votre fichier de spécification OpenAPI.Longueur minimale : 1

string

Répertoire dans lequel rechercher des fichiers OpenAPI.N’incluez pas de barre oblique initiale.

string or array or object

Fichiers de spécification AsyncAPI pour générer la documentation API. Peut être une seule URL/un seul chemin ou un tableau d’URL/de chemins.

Afficher Asyncapi

string

URL ou chemin vers votre fichier de spécification AsyncAPI.Longueur minimale : 1

string

Répertoire dans lequel rechercher des fichiers AsyncAPI.N’incluez pas de barre oblique initiale.

object

Paramètres d’affichage des paramètres d’API.

Afficher Params

"all" | "closed"

Indique s’il faut développer tous les paramètres par défaut. Valeur par défaut : closed.

object

Paramètres du terrain de jeu API.

Afficher Playground

"interactive" | "simple" | "none"

Mode d’affichage du terrain de jeu API. Valeur par défaut : interactive.

boolean

Indique s’il faut faire transiter les requêtes API par un serveur proxy. Valeur par défaut : true.

object

Paramètres pour les exemples API générés automatiquement.

Afficher Examples

array of string

Langages d’exemple pour les Snippets API générés automatiquement

"required" | "all"

Indique s’il faut afficher les paramètres optionnels dans les exemples API. Valeur par défaut : all.

object

Paramètres pour les pages API générées à partir de fichiers MDX.

Afficher Mdx

object

Configuration de l’authentification pour les requêtes API basées sur MDX.

Afficher Auth

"bearer" | "basic" | "key" | "cobo"

Méthode d’authentification pour les requêtes API.

string

Nom de l’authentification pour les requêtes API.

string or array

Configuration du serveur pour les requêtes API.

SEO et recherche

object

Configurations d’indexation SEO.

Afficher SEO

object

Balises meta ajoutées à chaque page. Doivent être des paires clé-valeur valides. Voir la référence des balises meta courantes pour les options.

"navigable" | "all"

Indiquez quelles pages les moteurs de recherche doivent indexer. Choisissez navigable pour n’indexer que les pages présentes dans la navigation de votre docs.json ou all pour indexer toutes les pages. Par défaut : navigable.

object

Paramètres d’affichage de la recherche.

Afficher Search

string

Texte indicatif à afficher dans la barre de recherche.

Intégrations

object

Intégrations de tiers.

Afficher Intégrations

object

Intégration d’Amplitude Analytics.

Afficher Amplitude

string

requis

Votre clé API Amplitude.

object

Intégration d’enrichissement de données Clearbit.

Afficher Clearbit

string

requis

Votre clé d’API Clearbit.

object

Intégration de Fathom Analytics.

Afficher Fathom

string

requis

L’identifiant de votre site Fathom.

object

Intégration du chat Front.

Afficher Frontchat

string

requis

L’ID de votre extrait de code Front Chat.Longueur minimale : 6

object

Intégration à Google Analytics 4.

Afficher GA4

string matching ^G

requis

Votre ID de mesure Google Analytics 4.Doit correspondre au motif : ^G

object

Intégration de Google Tag Manager.

Afficher Gtm

string matching ^G

requis

Votre identifiant de balise Google Tag Manager.Doit correspondre au motif : ^G

object

Intégration à Heap Analytics.

Afficher Heap

string

requis

Votre ID d’application Heap.

object

Intégration à Hotjar.

Afficher Hotjar

string

requis

Votre identifiant Hotjar.

string

requis

La version du script Hotjar.

object

Intégration à Intercom.

Afficher Intercom

string

requis

L’ID de votre application Intercom.Longueur minimale : 6

object

Intégration de Koala.

Afficher Koala

string

requis

Votre clé d’API publique Koala.Longueur minimale : 2

object

Intégration LogRocket.

Afficher LogRocket

string

requis

L’ID d’application de votre projet LogRocket.

object

Intégration à Mixpanel.

Afficher Mixpanel

string

requis

Votre jeton de projet Mixpanel.

object

Intégration à Osano.

Afficher Osano

string

requis

Source de votre script Osano.

object

Intégration de Pirsch Analytics.

Afficher Pirsch

string

requis

Votre ID Pirsch.

object

Intégration PostHog.

Afficher PostHog

string matching ^phc\_

requis

Votre clé API PostHog.Doit correspondre au motif : ^phc_

string (uri)

Votre hôte de l’API PostHog.

object

Intégration à Plausible Analytics.

Afficher Plausible

string

requis

Votre domaine Plausible.

string

Votre serveur Plausible.

object

Intégration de Segment.

Afficher Segment

string

requis

Votre clé Segment.

object

Paramètres de télémétrie.

Afficher Telemetry

boolean

Indique s’il faut activer la télémétrie.

object

Paramètres de cookies.

Afficher Cookies

string

Clé du cookie.

string

Valeur du cookie.

Erreurs

object

Paramètres de gestion des erreurs.

Afficher Erreurs

object

Gestion de l’erreur 404 « Page non trouvée ».

Afficher 404

boolean

Indique s’il faut rediriger automatiquement vers la page d’accueil lorsqu’une page est introuvable.

string

Titre personnalisé pour la page d’erreur 404.

string

Description personnalisée pour la page d’erreur 404. Prend en charge le formatage Markdown.

Exemples

Exemple de base
Exemple d’API interactif
Exemple multilingue

docs.json

{
  "$schema": "https://mintlify.com/docs.json",
  "theme": "maple",
  "name": "Example Co.",
  "description": "Example Co. est une entreprise qui fournit du contenu d’exemple et du texte factice.",
  "colors": {
    "primary": "#3B82F6",
    "light": "#F8FAFC",
    "dark": "#0F172A"
  },
  "navigation": {
    "dropdowns": [
      {
        "dropdown": "Documentation",
        "icon": "book",
        "description": "Comment utiliser le produit Example Co.",
        "groups": [
          {
            "group": "Bien démarrer",
            "pages": [
              "index",
              "quickstart"
            ]
          },
          {
            "group": "Personnalisation",
            "pages": [
              "settings",
              "users",
              "features"
            ]
          },
          {
            "group": "Facturation",
            "pages": [
              "billing/overview",
              "billing/payments",
              "billing/subscriptions"
            ]
          }
        ]
      },
      {
        "dropdown": "Journal des modifications",
        "icon": "history",
        "description": "Mises à jour et changements",
        "pages": [
          "changelog"
        ]
      }
    ]
  },
  "logo": {
    "light": "/logo-light.svg",
    "dark": "/logo-dark.svg",
    "href": "https://example.com"
  },
  "navbar": {
    "links": [
      {
        "label": "Communauté",
        "href": "https://example.com/community"
      }
    ],
    "primary": {
      "type": "button",
      "label": "Commencer",
      "href": "https://example.com/start"
    }
  },
  "footer": {
    "socials": {
      "x": "https://x.com/example",
      "linkedin": "https://www.linkedin.com/company/example",
      "github": "https://github.com/example",
      "slack": "https://example.com/community"
    },
    "links": [
      {
        "header": "Ressources",
        "items": [
          {
            "label": "Clients",
            "href": "https://example.com/customers"
          },
          {
            "label": "Offre Entreprise",
            "href": "https://example.com/enterprise"
          },
          {
            "label": "Demander un aperçu",
            "href": "https://example.com/preview"
          }
        ]
      },
      {
        "header": "Entreprise",
        "items": [
          {
            "label": "Carrières",
            "href": "https://example.com/careers"
          },
          {
            "label": "Blog",
            "href": "https://example.com/blog"
          },
          {
            "label": "Politique de confidentialité",
            "href": "https://example.com/legal/privacy"
          }
        ]
      }
    ]
  },
  "integrations": {
    "ga4": {
      "measurementId": "G-XXXXXXXXXX"
    },
    "koala": {
      "publicApiKey": "pk_example_key_123"
    },
    "telemetry": {
      "enabled": true
    },
    "cookies": {
      "key": "example_cookie_key",
      "value": "example_cookie_value"
    }
  },
  "contextual": {
    "options": [
      "copy",
      "view",
      "chatgpt",
      "claude"
    ]
  },
  "errors": {
    "404": {
      "redirect": false,
      "title": "Introuvable",
      "description": "Qu’est-il arrivé à cette _page_ ?"
    }
  }
}

docs.json

{
  "$schema": "https://mintlify.com/docs.json",
  "theme": "maple",
  "name": "Example Co.",
  "description": "Example Co. est une entreprise qui fournit du contenu d’exemple et du texte de substitution.",
  "colors": {
    "primary": "#3B82F6",
    "light": "#F8FAFC",
    "dark": "#0F172A"
  },
  "navigation": {
    "dropdowns": [
      {
        "dropdown": "Documentation",
        "icon": "book",
        "description": "Comment utiliser le produit Example Co.",
        "groups": [
          {
            "group": "Prise en main",
            "pages": [
              "index",
              "quickstart"
            ]
          },
          {
            "group": "Personnalisation",
            "pages": [
              "settings",
              "users",
              "features"
            ]
          },
          {
            "group": "Facturation",
            "pages": [
              "billing/overview",
              "billing/payments",
              "billing/subscriptions"
            ]
          }
        ]
      },
      {
        "dropdown": "Référence de l’API",
        "icon": "terminal",
        "description": "Comment utiliser l’API d’Example Co.",
        "groups": [
          {
            "group": "Référence de l’API",
            "pages": [
              "api-reference/introduction"
            ]
          },
          {
            "group": "Endpoints",
            "openapi": {
              "source": "openapi.json"
            }
          }
        ]
      },
      {
        "dropdown": "Journal des modifications",
        "icon": "history",
        "description": "Mises à jour et changements",
        "pages": [
          "changelog"
        ]
      }
    ]
  },
  "api": {
    "playground": {
      "display": "interactive",
    },
    "examples": {
      "languages": ["javascript", "curl", "python"]
    }
  },
  "logo": {
    "light": "/logo-light.svg",
    "dark": "/logo-dark.svg",
    "href": "https://example.com"
  },
  "navbar": {
    "links": [
      {
        "label": "Communauté",
        "href": "https://example.com/community"
      }
    ],
    "primary": {
      "type": "button",
      "label": "Commencer",
      "href": "https://example.com/start"
    }
  },
  "footer": {
    "socials": {
      "x": "https://x.com/example",
      "linkedin": "https://www.linkedin.com/company/example",
      "github": "https://github.com/example",
      "slack": "https://example.com/community"
    },
    "links": [
      {
        "header": "Ressources",
        "items": [
          {
            "label": "Clients",
            "href": "https://example.com/customers"
          },
          {
            "label": "Offre Entreprise",
            "href": "https://example.com/enterprise"
          },
          {
            "label": "Demander un aperçu",
            "href": "https://example.com/preview"
          }
        ]
      },
      {
        "header": "Entreprise",
        "items": [
          {
            "label": "Carrières",
            "href": "https://example.com/careers"
          },
          {
            "label": "Blog",
            "href": "https://example.com/blog"
          },
          {
            "label": "Politique de confidentialité",
            "href": "https://example.com/legal/privacy"
          }
        ]
      }
    ]
  },
  "integrations": {
    "ga4": {
      "measurementId": "G-XXXXXXXXXX"
    },
    "koala": {
      "publicApiKey": "pk_example_key_123"
    },
    "telemetry": {
      "enabled": true
    },
    "cookies": {
      "key": "example_cookie_key",
      "value": "example_cookie_value"
    }
  },
  "contextual": {
    "options": [
      "copy",
      "view",
      "chatgpt",
      "claude"
    ]
  },
  "errors": {
    "404": {
      "redirect": false,
      "title": "Introuvable",
      "description": "Que s’est-il donc passé avec cette _page_ ?"
    }
  }
}

docs.json

{
  "$schema": "https://mintlify.com/docs.json",
  "theme": "maple",
  "name": "Example Co.",
  "description": "Example Co. est une entreprise qui fournit du contenu d’exemple et du texte de remplissage.",
  "colors": {
    "primary": "#3B82F6",
    "light": "#F8FAFC",
    "dark": "#0F172A"
  },
  "navigation": {
    "global": {
      "anchors": [
        {
          "anchor": "Documentation",
          "href": "https://mintlify.com/docs"
        },
        {
          "anchor": "Journal des modifications",
          "href": "https://mintlify.com/docs/changelog"
        }
      ]
    },
    "languages": [ 
      {
        "language": "en",
        "dropdowns": [
          {
            "dropdown": "Documentation",
            "icon": "book",
            "description": "Comment utiliser le produit Example Co.",
            "pages": [
              {
                "group": "Pour commencer",
                "pages": ["index", "quickstart"]
              },
              {
                "group": "Personnalisation",
                "pages": ["settings", "users", "features"]
              },
              {
                "group": "Facturation",
                "pages": [
                  "billing/overview",
                  "billing/payments",
                  "billing/subscriptions"
                ]
              }
            ]
          },
          {
            "dropdown": "Journal des modifications",
            "icon": "history",
            "description": "Mises à jour et modifications",
            "pages": ["changelog"]
          }
        ]
      },
      {
        "language": "es",
        "dropdowns": [
          {
            "dropdown": "Documentación",
            "icon": "book",
            "description": "Cómo usar el producto de Example Co.",
            "pages": [
              {
                "group": "Comenzando",
                "pages": ["es/index", "es/quickstart"]
              },
              {
                "group": "Personalización",
                "pages": ["es/settings", "es/users", "es/features"]
              },
              {
                "group": "Billing",
                "pages": [
                  "es/billing/overview",
                  "es/billing/payments",
                  "es/billing/subscriptions"
                ]
              }
            ]
          },
          {
            "dropdown": "Changelog",
            "icon": "history",
            "description": "Actualizaciones y cambios",
            "pages": ["es/changelog"]
          }
        ]
      }
    ]
  },
  "logo": {
    "light": "/logo-light.svg",
    "dark": "/logo-dark.svg",
    "href": "https://example.com"
  },
  "navbar": {
    "links": [
      {
        "label": "Communauté",
        "href": "https://example.com/community"
      }
    ],
    "primary": {
      "type": "button",
      "label": "Commencer",
      "href": "https://example.com/start"
    }
  },
  "footer": {
    "socials": {
      "x": "https://x.com/example",
      "linkedin": "https://www.linkedin.com/company/example",
      "github": "https://github.com/example",
      "slack": "https://example.com/community"
    },
    "links": [
      {
        "header": "Ressources",
        "items": [
          {
            "label": "Clients",
            "href": "https://example.com/customers"
          },
          {
            "label": "Offre Entreprise",
            "href": "https://example.com/enterprise"
          },
          {
            "label": "Demander un aperçu",
            "href": "https://example.com/preview"
          }
        ]
      },
      {
        "header": "Société",
        "items": [
          {
            "label": "Carrières",
            "href": "https://example.com/careers"
          },
          {
            "label": "Blog",
            "href": "https://example.com/blog"
          },
          {
            "label": "Politique de confidentialité",
            "href": "https://example.com/legal/privacy"
          }
        ]
      }
    ]
  },
  "integrations": {
    "ga4": {
      "measurementId": "G-XXXXXXXXXX"
    },
    "koala": {
      "publicApiKey": "pk_example_key_123"
    },
    "telemetry": {
      "enabled": true
    },
    "cookies": {
      "key": "example_cookie_key",
      "value": "example_cookie_value"
    }
  },
  "contextual": {
    "options": ["copy", "view", "chatgpt", "claude"]
  },
  "errors": {
    "404": {
      "redirect": false,
      "title": "Introuvable",
      "description": "Qu’est-il arrivé à cette _page_ ?"
    }
  }
}

Mise à niveau depuis `mint.json`

Si votre projet de documentation utilise le fichier obsolète mint.json, suivez ces étapes pour passer à docs.json.

Installer ou mettre à jour la CLI

Si vous n’avez pas encore installé la CLI, installez-la maintenant :

npm i -g mint

yarn global add mint

pnpm add -g mint

Si la CLI est déjà installée, assurez-vous qu’elle est à jour :

mint update

Créer votre fichier docs.json

Dans votre dépôt de documentation, exécutez :

mint upgrade

Cette commande créera un fichier docs.json à partir de votre mint.json existant. Passez en revue le fichier généré pour vérifier que tous les paramètres sont corrects.

Supprimer votre fichier mint.json

Après avoir confirmé que votre docs.json est correctement configuré, vous pouvez supprimer en toute sécurité votre ancien fichier mint.json.

Démarrage

Configuration de base

Optimisation de l’IA

Composants

Pages API

Authentification et personnalisation

Guides

Intégrations

Contrôle de version et CI/CD

Paramètres globaux

Configuration de votre `docs.json`

Référence

Personnalisation

Structure

Configurations d’API

SEO et recherche

Intégrations

Erreurs

Exemples

Mise à niveau depuis `mint.json`

​Configuration de votre docs.json

​Référence

​Personnalisation

​Structure

​Configurations d’API

​SEO et recherche

​Intégrations

​Erreurs

​Exemples

​Mise à niveau depuis mint.json

Configuration de votre `docs.json`

Référence

Personnalisation

Structure

Configurations d’API

SEO et recherche

Intégrations

Erreurs

Exemples

Mise à niveau depuis `mint.json`