Appearance and branding

The primary color for your documentation. Generally used for emphasis in light mode, with some variation by theme.

Must be a hex code beginning with #. Example: "#0D9373".

The color used for emphasis in dark mode.

Must be a hex code beginning with #.

The color used for buttons and hover states across both light and dark modes, with some variation by theme.

Must be a hex code beginning with #.

Path to your logo file for light mode. Include the file extension. Example: /logo/light.svg.

Path to your logo file for dark mode. Include the file extension. Example: /logo/dark.svg.

The URL to redirect to when clicking the logo. If not provided, the logo links to the first page of the currently selected locale for internationalized docs, or to your homepage for single-language sites. Example: https://yoursite.com.

Path to your favicon for light mode. Include the file extension. Example: /favicon.png.

Path to your favicon for dark mode. Include the file extension. Example: /favicon-dark.png.

Default color mode. Choose system to match the user’s OS setting, or light or dark to force a specific mode. Defaults to system.

When true, hides the light/dark mode toggle so users cannot switch modes. Defaults to false.

Font family name, such as "Inter" or "Open Sans". Supports Google Fonts family names—these load automatically without a source required.

Font weight, such as 400 or 700. Variable fonts support fractional weights such as 550.

URL to a hosted font or a path to a local font file. Not needed for Google Fonts.

• Hosted: https://example.com/fonts/MyFont.woff2
• Local: /fonts/MyFont.woff2

Font file format. Required when using the source field.

Override font settings for headings only.

Accepts the same family, weight, source, and format fields as the top-level fonts object.

Override font settings for body text only.

Accepts the same family, weight, source, and format fields as the top-level fonts object.

Icon library to use throughout your documentation. Defaults to fontawesome.

A decorative background pattern for your theme.

Custom background colors for light and dark modes.

Background image for your site. Provide a single path or separate paths for light and dark mode.

The style of the page eyebrow (the label shown at the top of the page). Choose section to show the section name or breadcrumbs to show the full navigation path. Defaults to section.

Controls whether LaTeX stylesheets load. By default, Mintlify automatically detects LaTeX usage in your content and loads the necessary stylesheets.

• Set to true to force-load LaTeX stylesheets when auto-detection fails.
• Set to false to prevent loading LaTeX stylesheets for better performance if you don’t use math expressions.

Code block theme. Defaults to "system".

• "system": Matches the current site mode (light or dark)
• "dark": Always uses dark mode
• A Shiki theme name string: applies that theme to all code blocks
• An object with light and dark keys: applies separate Shiki themes per mode

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

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

"styling": {
  "codeblocks": {
    "languages": {
      "custom": ["/languages/my-language.json"]
    }
  }
}

Visual theme for thumbnails. If not set, thumbnails use your site’s color scheme defined by colors.

Background image for thumbnails. Can be a relative path or absolute URL.

Font configuration for thumbnails. Only supports Google Fonts family names.