Contextual menu

Add a contextual menu to your docs with one-click AI integrations for ChatGPT, Claude, Perplexity, Google AI Studio, Devin, Windsurf, and MCP tools.

The contextual menu provides quick access to AI-optimized content and direct integrations with popular AI tools. When users click the contextual menu on any page, they can copy content as context for AI tools or open it in an AI conversation. Supported tools include ChatGPT, Claude, Perplexity, Google AI Studio, Grok, Devin, Windsurf, and any custom tool you configure.

Pair the contextual menu with your hosted skill.md file and MCP server so that users can install your product’s full capabilities into their AI tools, not just the page they are reading.

Menu options

The contextual menu includes several pre-built options that you can enable by adding their identifier to your configuration.

Option	Identifier	Description
Copy page	copy	Copies the current page as Markdown for pasting as context into AI tools
View as Markdown	view	Opens the current page as Markdown
Ask assistant	assistant	Opens the assistant with the current page as context
Download PDF	download-pdf	Downloads the current page as a PDF. Available on Enterprise plans.
Open in ChatGPT	chatgpt	Creates a ChatGPT conversation with the current page as context
Open in Claude	claude	Creates a Claude conversation with the current page as context
Open in Perplexity	perplexity	Creates a Perplexity conversation with the current page as context
Open in Grok	grok	Creates a Grok conversation with the current page as context
Open in Google AI Studio	aistudio	Creates a Google AI Studio conversation with the current page as context
Open in Devin	devin	Creates a Devin session with the current page as context
Open in Windsurf	windsurf	Opens Windsurf Cascade with the current page as context
Copy MCP server URL	mcp	Copies your MCP server URL to the clipboard
Copy MCP install command	add-mcp	Copies the npx add-mcp command to install the MCP server
Connect to Cursor	cursor	Installs your hosted MCP server in Cursor
Connect to VS Code	vscode	Installs your hosted MCP server in VS Code
Connect to Devin	devin-mcp	Installs your hosted MCP server in Devin
Download API spec	download-spec	Downloads your deployment’s OpenAPI spec. If there are multiple specs, downloads them as a zip archive. Only appears on API reference pages.
Download PDF	download-pdf	Downloads the current page as a PDF
Custom options	Object	Add custom options to the contextual menu

Enable the contextual menu

Add the contextual field to your docs.json file and specify which options you want to include.

{
 "contextual": {
   "options": [
     "copy",
     "view",
     "assistant",
     "chatgpt",
     "claude",
     "perplexity",
     "grok",
     "aistudio",
     "devin",
     "windsurf",
      "mcp",
      "cursor",
      "vscode",
      "devin-mcp",
      "download-spec",
      "download-pdf"
    ]
 }
}

Display location

By default, the contextual menu appears in the page header. You can configure it to display in the table of contents sidebar instead using the display option.

{
  "contextual": {
    "options": ["copy", "view", "chatgpt", "claude"],
    "display": "toc"
  }
}

Value	Description
header	Displays options in the top-of-page context menu (default)
toc	Displays options in the table of contents sidebar

Add custom options

Create custom options in the contextual menu by adding an object to the options array. Each custom option requires these properties:

title · string · required

The title of the option.

description · string · required

The description of the option. Displayed beneath the title when the contextual menu expands.

icon · string · required

The icon to display.

Options:

• Font Awesome icon name, if you have the icons.library property set to fontawesome in your docs.json
• Lucide icon name, if you have the icons.library property set to lucide in your docs.json
• Tabler icon name, if you have the icons.library property set to tabler in your docs.json
• URL to an externally hosted icon
• Path to an icon file in your project

iconType · string

The Font Awesome icon style. Only used with Font Awesome icons.

Options: regular, solid, light, thin, sharp-solid, duotone, brands.

href · string | object · required

The href of the option. Use a string for simple links or an object for dynamic links with query parameters.

Show href object

base · string · required

The base URL for the option.

query · object · required

The query parameters for the option.

Show query object

key · string · required

The query parameter key.

value · string · required

The query parameter value. Mintlify replaces the following placeholders with the corresponding values:

• Use $page to insert the current page content in Markdown.
• Use $path to insert the current page path.
• Use $mcp to insert the hosted MCP server URL.

Example custom option:

{
    "contextual": {
        "options": [
            "copy",
            "view",
            "chatgpt",
            "claude",
            "perplexity",
            {
                "title": "Request a feature",
                "description": "Join the discussion on GitHub to request a new feature",
                "icon": "plus",
                "href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests"
            }
        ]
    }
}

Custom option examples

Simple link

{
  "title": "Request a feature",
  "description": "Join the discussion on GitHub",
  "icon": "plus",
  "href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests"
}

Dynamic link with page content

{
  "title": "Share on X",
  "description": "Share this page on X",
  "icon": "x",
  "href": {
    "base": "https://x.com/intent/tweet",
    "query": [
      {
      "key": "text",
      "value": "Check out this documentation: $page"
      }
    ]
  }
}