Contextual menu

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

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

Add the contextual field to your docs.json file and specify which options you want to include. Options appear in the menu in the order you list them.

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

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

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) — 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
• A single emoji (for example, 💡 or 🚀)

• src (string) — Path or URL to an image to use as the icon. Use src instead of icon when you want to use a custom image rather than an icon from a library.

Options:

• Path to an image file in your project (for example, /images/my-icon.svg)
• URL to an externally hosted image (for example, https://example.com/icon.png)

• 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.

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

To override the global contextual menu on a specific page, add the contextual field to the page's frontmatter. Override the global contextual menu to surface page-specific actions like download-pdf on a terms of service page, or to hide the menu entirely on a landing page.

The page-level contextual object replaces the global one for that page. Omit the field to inherit docs.json, or set options: [] to disable the contextual menu on that page.

---
title: "Terms of Service"
contextual:
  options:
    - copy
    - download-pdf
  display: header
---

The same fields and validation rules apply as in docs.json, including custom options and the display setting. If a page override is invalid, Mintlify falls back to the global contextual configuration.

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

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

• Search Model Context Protocol (MCP) server
• Analytics integrations
• AI-native documentation