diff --git a/organize/settings.mdx b/organize/settings.mdx
index d1e1d7dbb..72a38c1de 100644
--- a/organize/settings.mdx
+++ b/organize/settings.mdx
@@ -304,7 +304,7 @@ This section contains the full reference for the `docs.json` file.
Default theme mode. Choose `system` to match users' OS settings, or `light` or `dark` to force a specific mode. Defaults to `system`.
- Whether to hide the light/dark mode toggle. Defaults to `true`.
+ Whether to hide the light/dark mode toggle. Defaults to `false`.
@@ -612,8 +612,8 @@ This section contains the full reference for the `docs.json` file.
Site-wide banner displayed at the top of pages.
-
- The content of the banner. Supports plain text and Markdown formatting. For example:
+
+ The text content displayed in the banner. Supports basic MDX formatting including links, bold, and italic text. Custom components are not supported. For example:
```json
{
@@ -622,7 +622,7 @@ This section contains the full reference for the `docs.json` file.
```
- Whether users can dismiss the banner. Defaults to `false`.
+ Whether to show the dismiss button on the right side of the banner. Defaults to `false`.
@@ -647,7 +647,7 @@ This section contains the full reference for the `docs.json` file.
Contextual menu for AI-optimized content and integrations.
-
+
Actions available in the contextual menu. The first option appears as the default.
- `copy`: Copy the current page as Markdown to the clipboard.
@@ -659,6 +659,28 @@ This section contains the full reference for the `docs.json` file.
- `cursor`: Installs your hosted MCP server in Cursor.
- `vscode`: Installs your hosted MCP server in VSCode.
+ Define custom contextual menu options as objects with the following properties:
+
+
+
+ Display title for the custom option.
+
+
+ Description text for the custom option.
+
+
+ Icon for the custom option. Supports icon library names, URLs, paths, or SVG code.
+
+
+ Link destination for the custom option. Can be a simple URL string or an object with `base` and optional `query` parameters.
+
+ Placeholder values:
+ - `$page`: Current page content
+ - `$path`: Current page path
+ - `$mcp`: MCP server URL
+
+
+
+
+ Microsoft Clarity integration.
+
+
+
+ Your Microsoft Clarity project ID.
+
+
+
Clearbit data enrichment integration.
@@ -882,6 +913,18 @@ This section contains the full reference for the `docs.json` file.
+
+ Hightouch integration.
+
+
+
+ Your Hightouch write key.
+
+
+ Your Hightouch API host.
+
+
+
Hotjar integration.
@@ -953,9 +996,6 @@ This section contains the full reference for the `docs.json` file.
Your PostHog API host.
-
- Enable or disable session recording.
-
@@ -1018,13 +1058,13 @@ This section contains the full reference for the `docs.json` file.
- Whether to automatically redirect to the home page when a page is not found.
+ Whether to automatically redirect to the home page when a page is not found. Defaults to `true`.
Custom title for the 404 error page.
- Custom description for the 404 error page. Supports Markdown formatting.
+ Custom description for the 404 error page. Supports basic MDX formatting including links, bold, and italic text. Custom components are not supported.