Pull request for mintlify/sync-mintlify-mint-repo-discrepancies-32754

organize/settings.mdx

@@ -50,7 +50,7 @@
 </ResponseField>
 
 <ResponseField name="colors" type="object" required>
   The colors used in your documentation. Colors are applied differently across themes. If you only provide a primary color, it will be used for all color elements.
 
   <Expandable title="Colors">
     <ResponseField name="primary" type="string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$" required>
@@ -115,7 +115,7 @@
       Background image for your thumbnails. Can be a relative path or absolute URL.
     </ResponseField>
     <ResponseField name="fonts" type="object">
       Font configuration for thumbnails. Only Google Fonts family names are supported.
 
       <Expandable title="Fonts">
         <ResponseField name="family" type="string" required>
@@ -304,7 +304,7 @@
       Default theme mode. Choose `system` to match users' OS settings, or `light` or `dark` to force a specific mode. Defaults to `system`.
     </ResponseField>
     <ResponseField name="strict" type="boolean">
-      Whether to hide the light/dark mode toggle. Defaults to `true`.
+      Whether to hide the light/dark mode toggle. Defaults to `false`.
     </ResponseField>
   </Expandable>
 </ResponseField>
@@ -550,7 +550,7 @@
 
   <Expandable title="Interaction">
     <ResponseField name="drilldown" type="boolean">
       Control automatic navigation behavior when selecting navigation groups. Set to `true` to force navigation to the first page when a navigation group is expanded. Set to `false` to prevent navigation and only expand or collapse the group. Leave unset to use the theme's default behavior.
     </ResponseField>
   </Expandable>
 </ResponseField>
@@ -560,7 +560,7 @@
 
   <Expandable title="Metadata">
     <ResponseField name="timestamp" type="boolean">
       Enable the last modified date on all pages. When enabled, all pages will display the date the content was last modified. Defaults to `false`.
     </ResponseField>
   </Expandable>
 </ResponseField>
@@ -612,8 +612,8 @@
   Site-wide banner displayed at the top of pages.
 
   <Expandable title="Banner">
-    <ResponseField name="content" type="string">
-      The content of the banner. Supports plain text and Markdown formatting. For example:
+    <ResponseField name="content" type="string" required>
+      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 @@
       ```
     </ResponseField>
     <ResponseField name="dismissible" type="boolean">
-      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`.
     </ResponseField>
   </Expandable>
 </ResponseField>
@@ -638,7 +638,7 @@
       Destination path to redirect to. Example: `/new-page`
     </ResponseField>
     <ResponseField name="permanent" type="boolean">
       Whether to use a permanent redirect (301). Defaults to `true`.
     </ResponseField>
   </Expandable>
 </ResponseField>
@@ -647,7 +647,7 @@
   Contextual menu for AI-optimized content and integrations.
 
   <Expandable title="Contextual">
-    <ResponseField name="options" type='array of "copy" | "view" | "chatgpt" | "claude" | "perplexity" | "mcp" | "cursor" | "vscode"' required>
+    <ResponseField name="options" type='array of "copy" | "view" | "chatgpt" | "claude" | "perplexity" | "mcp" | "cursor" | "vscode" | object' required>
       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 @@
       - `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:
+
+      <Expandable title="Custom option">
+        <ResponseField name="title" type="string" required>
+          Display title for the custom option.
+        </ResponseField>
+        <ResponseField name="description" type="string" required>
+          Description text for the custom option.
+        </ResponseField>
+        <ResponseField name="icon" type="string">
+          Icon for the custom option. Supports icon library names, URLs, paths, or SVG code.
+        </ResponseField>
+        <ResponseField name="href" type="string or object" required>
+          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
+        </ResponseField>
+      </Expandable>
+
       <img
         src="/images/page-context-menu.png"
         alt="Contextual Menu"
@@ -672,7 +694,7 @@
   </Expandable>
 </ResponseField>
 
 ### API Configurations
 
 <ResponseField name="api" type="object">
   API documentation and interactive playground settings.
@@ -782,10 +804,10 @@
   </Expandable>
 </ResponseField>
 
 ### SEO and search
 
 <ResponseField name="seo" type="object">
   SEO indexing configurations.
 
   <Expandable title="Seo">
     <ResponseField name="metatags" type="object">
@@ -822,6 +844,15 @@
         </ResponseField>
       </Expandable>
     </ResponseField>
+    <ResponseField name="clarity" type="object">
+      Microsoft Clarity integration.
+
+      <Expandable title="Clarity">
+        <ResponseField name="projectId" type="string" required>
+          Your Microsoft Clarity project ID.
+        </ResponseField>
+      </Expandable>
+    </ResponseField>
     <ResponseField name="clearbit" type="object">
       Clearbit data enrichment integration.
 
@@ -882,6 +913,18 @@
         </ResponseField>
       </Expandable>
     </ResponseField>
+    <ResponseField name="hightouch" type="object">
+      Hightouch integration.
+
+      <Expandable title="Hightouch">
+        <ResponseField name="writeKey" type="string" required>
+          Your Hightouch write key.
+        </ResponseField>
+        <ResponseField name="apiHost" type="string">
+          Your Hightouch API host.
+        </ResponseField>
+      </Expandable>
+    </ResponseField>
     <ResponseField name="hotjar" type="object">
       Hotjar integration.
 
@@ -953,9 +996,6 @@
         <ResponseField name="apiHost" type="string (uri)">
           Your PostHog API host.
         </ResponseField>
-        <ResponseField name="sessionRecording" type="boolean" default="true">
-          Enable or disable session recording.
-        </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="plausible" type="object">
@@ -1018,13 +1058,13 @@
 
       <Expandable title="404">
         <ResponseField name="redirect" type="boolean">
-          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`.
         </ResponseField>
         <ResponseField name="title" type="string">
           Custom title for the 404 error page.
         </ResponseField>
         <ResponseField name="description" type="string">
-          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.
         </ResponseField>
       </Expandable>
     </ResponseField>