Global Settings

Every Mintlify site needs a mint.json file with the core configuration settings. Learn more about the properties below.

Properties

string

必填

Name of your project. Used for the global title.Example: mintlify

An array of groups with all the pages within that group

显示 Navigation

string

The name of the group.Example: Settings

string[]

The relative paths to the markdown files that will serve as pages.Example: ["customization", "page"]

string or object

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

显示 Logo

string

Path to the logo in light mode

string

Path to the logo in dark mode

string

默认值:"/"

Where clicking on the logo links you to

string

Path to the favicon image

Colors

Hex color codes for your global theme

显示 Colors

string

必填

The primary color. Used for most often for highlighted content, section headers, accents, in light mode

string

The primary color for dark mode. Used for most often for highlighted content, section headers, accents, in dark mode

string

The primary color for important buttons

object

The color of the background in both light and dark mode

显示 Object

string

必填

The hex color code of the background in light mode

string

必填

The hex color code of the background in dark mode

TopbarLink[]

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

显示 TopbarLink

string

The name of the button.Example: Contact us

string

The url once you click on the button. Example: https://mintlify.com/contact

Call to Action

显示 Topbar Call to Action

"link" or "github"

默认值:"link"

Link shows a button. GitHub shows the repo information at the url provided including the number of GitHub stars.

string

If link: What the button links to.If github: Link to the repository to load GitHub information from.

string

Text inside the button. Only required if type is a link.

string[]

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

Anchor[]

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

显示 Anchor

string

The Font Awesome icon used to feature the anchor.Example: comments

string

The name of the anchor label.Example: Community

string

The start of the URL that marks what pages go in the anchor. Generally, this is the name of the folder you put your pages in.

string

The hex color of the anchor icon background. Can also be a gradient if you pass an object with the properties from and to that are each a hex color.

string

Used if you want to hide an anchor until the correct docs version is selected.

boolean

默认值:"false"

Pass true if you want to hide the anchor until you directly link someone to docs inside it.

string

默认值:"duotone"

One of: “brands”, “duotone”, “light”, “sharp-solid”, “solid”, or “thin”

Object

Override the default configurations for the top-most anchor.

显示 Object

string

默认值:"Documentation"

The name of the top-most anchor

string

默认值:"book-open"

Font Awesome icon.

string

默认值:"duotone"

One of: “brands”, “duotone”, “light”, “sharp-solid”, “solid”, or “thin”

Tabs[]

An array of navigational tabs.

显示 Tabs

string

The name of the tab label.

string

The start of the URL that marks what pages go in the tab. Generally, this is the name of the folder you put your pages in.

API

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

显示 API

string

The base url for all API endpoints. If baseUrl is an array, it will enable for multiple base url options that the user can toggle.

Auth

显示 Auth

"bearer" | "basic" | "key"

The authentication strategy used for all API endpoints.

string

The name of the authentication parameter used in the API playground.If method is basic, the format should be [usernameName]:[passwordName]

string

The default value that’s designed to be a prefix for the authentication input field.E.g. If an inputPrefix of AuthKey would inherit the default input result of the authentication field as AuthKey.

Playground

Configurations for the API playground

显示 Playground

"show" | "simple" | "hide"

默认值:"show"

Whether the playground is showing, hidden, or only displaying the endpoint with no added user interactivity simpleLearn more at the playground guides

boolean

Enabling this flag ensures that key ordering in OpenAPI pages matches the key ordering defined in the OpenAPI file.

This behavior will soon be enabled by default, at which point this field will be deprecated.

string | string[]

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

json Absolute "openapi": "https://example.com/openapi.json"  json Relative "openapi": "/openapi.json" 
json Multiple "openapi": ["https://example.com/openapi1.json", "/openapi2.json", "/openapi3.json"]

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"
}

显示 FooterSocials

string

One of the following values website, facebook, twitter, discord, slack, github, linkedin, instagram, hacker-newsExample: twitter

string

The URL to the social platform.Example: https://twitter.com/mintlify

Feedback

Configurations to enable feedback buttons

显示 Feedback

boolean

默认值:"false"

Enables a button to allow users to suggest edits via pull requests

boolean

默认值:"false"

Enables a button to allow users to raise an issue about the documentation

ModeToggle

Customize the dark mode toggle.

显示 ModeToggle

"light" or "dark"

Set if you always want to show light or dark mode for new users. When not set, we default to the same mode as the user’s operating system.

boolean

默认值:"false"

Set to true to hide the dark/light mode toggle. You can combine isHidden with default to force your docs to only use light or dark mode. For example:

"modeToggle": {
  "default": "dark",
  "isHidden": true
}

"modeToggle": {
  "default": "light",
  "isHidden": true
}

string

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

入门指南

功能使用

会员订阅与支持

技术支持

Properties

​Properties

Properties