Contextual menu

Add one-click AI integrations to your docs

The contextual menu provides quick access to AI-optimized content and direct integrations with popular AI tools. When users select the contextual menu on any page, they can copy content as context for AI tools or open conversations in ChatGPT, Claude, Perplexity, or a custom tool of your choice with your documentation already loaded as context.

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
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
Copy MCP Server URL	mcp	Copies the MCP server URL to the clipboard
Open in Cursor	cursor	Installs the hosted MCP server in Cursor
Open in VSCode	vscode	Installs the hosted MCP server in VSCode

Enabling the contextual menu

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

{
 "contextual": {
   "options": [
     "copy",
     "view",
     "chatgpt",
     "claude",
     "perplexity",
     "mcp",
     "cursor",
     "vscode"
   ]
 }
}

Adding 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 is expanded.

icon · string · required

The icon of the option. Accepts any icon from the Icons collection.

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. We will replace 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"
    }
  }
}