Every Mintlify site needs a mint.json file with the core configuration settings. Learn more about the properties or from an example

Properties

Styling

name
string
required

Name of your company or project. Used for the global title.

logo
string or object

Path to logo image or object with path to “light” and “dark” mode logo images

favicon
string

Path to the favicon image. For example: /path/to/favicon.svg

colors
Colors

Hex color codes for your global theme

backgroundImage
string

A background image to be displayed behind every page. See example with Infisical and FRPC.

modeToggle
ModeToggle

Customize the dark mode toggle.

Structure

navigation
Navigation[]
required

An array of groups with all the pages within that group

topbarLinks
TopbarLink[]

Array of names and urls of links you want to include in the topbar

topbarCtaButton
Call to Action
versions
string[]

Array of version names. Only use this if you want to show different versions of docs with a dropdown in the navigation bar.

anchors
Anchor[]

An array of the anchors, includes the icon, color, and url.

topAnchor
Object

Override the default configurations for the top-most anchor. Note: if you have tabs configured, this does not apply.

tabs
Tabs[]

An array of navigational tabs.

Example:

"tabs": [
  {
    "name": "Writing Content",
    "url": "content"
  },
  {
    "name": "API References",
    "url": "api-playground"
  }
]
footerSocials
FooterSocials

An object of social media accounts where the key:property pair represents the social media platform and the account url.

Example:

{
  "twitter": "https://twitter.com/mintlify",
  "website": "https://mintlify.com"
}
feedback
Feedback

Configurations to enable feedback buttons

search
Search

Configurations to change the search prompt

API Configurations

api
API

Configuration for API settings. Learn more about API pages at API Components.

openapi
string | string[]

A string or an array of strings of URL(s) or relative path(s) pointing to your OpenAPI file.

Examples:

"openapi": "https://example.com/openapi.json"

Integrations

integrations
Integrations

Configurations to add third-party integrations (excluding analytics integrations)

analytics
Analytics

Configurations to add third-party analytics integrations. See full list of supported analytics here.

Redirects

redirects
Redirect[]

An array of paths you want to configure to permanently redirect to another path

Example:

"redirects": [
  {
    "source": "/source/path",
    "destination": "/destination/path"
  }
]

Search Engine Optimization

seo
SEO

Settings for Search Engine Optimization.

Example:

"seo": {
  "indexHiddenPages": true
}

Example mint.json

Click on the following dropdown to view a sample configuration file