mintlify · mintlify · Jun 30, 2025 · Jun 30, 2025 · Jun 30, 2025 · Jun 30, 2025
diff --git a/ai-ingestion.mdx b/ai-ingestion.mdx
@@ -1,6 +1,6 @@
 ---
 title: "AI ingestion"
 description: "Prepare your documentation for LLMs and AI tools"
 icon: "bot-message-square"
 ---

@@ -12,7 +12,7 @@
  )
 }

 Mintlify generates optimized formats and provides shortcuts that help users get faster, more accurate responses when using your documentation as context for LLMs and AI tools.

 ## Contextual menu

@@ -40,8 +40,8 @@
   "options": [
     "copy",
     "view",
     "chatgpt",
     "claude"
   ]
 }
 }
@@ -49,19 +49,19 @@

 ## /llms.txt

 The [/llms.txt file](https://llmstxt.org) is an industry standard that helps general-purpose LLMs index more efficiently, similar to how a sitemap helps search engines.
 
 Every documentation site automatically hosts an `/llms.txt` file at the root that lists all available pages in your documentation. AI tools can use this file to understand your documentation structure and find relevant content to user prompts.
 
-<PreviewButton href="https://mintlify.com/docs/llms.txt">Open llms.txt for this site</PreviewButton>
+<PreviewButton href="/llms.txt">Open llms.txt for this site</PreviewButton>
 
 ## /llms-full.txt
 
 The `/llms-full.txt` file combines your entire documentation site into a single file as context for AI tools.
 
 Every documentation site automatically hosts an `/llms-full.txt` file at the root.
 
-<PreviewButton href="https://mintlify.com/docs/llms-full.txt">Open llms-full.txt for this site</PreviewButton>
+<PreviewButton href="/llms-full.txt">Open llms-full.txt for this site</PreviewButton>
 
 ## Generating Markdown versions of pages
 
@@ -71,8 +71,8 @@
 
 Add a `.md` to a page's URL to display a Markdown version of that page. 
 
-<PreviewButton href="https://mintlify.com/docs/quickstart.md">Open quickstart.md</PreviewButton>
+<PreviewButton href="/quickstart.md">Open quickstart.md</PreviewButton>
 
 ### Command \+ C shortcut
 
 Select Command \+ C (Ctrl \+ C on Windows) to copy any page as Markdown.
diff --git a/api-playground/customization.mdx b/api-playground/customization.mdx
diff --git a/api-playground/introduction.mdx b/api-playground/introduction.mdx
diff --git a/api-playground/settings.mdx b/api-playground/settings.mdx
diff --git a/api-playground/troubleshooting.mdx b/api-playground/troubleshooting.mdx
@@ -69,7 +69,7 @@ If your API pages aren't displaying correctly, check these common configuration
     requests, then all of these requests will fail. To fix this, configure your reverse proxy to
     allow `POST` requests to the `/api/request` path.
 
-    Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`, as described [here](settings#api-configurations). This will
+    Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`, as described [here](/settings#param-proxy). This will
     likely require you to configure CORS on your server, as these requests will now come directly
     from your users' browsers.
   </Accordion>

diff --git a/api-playground/usage.mdx b/api-playground/usage.mdx
diff --git a/components/accordion.mdx b/components/accordion.mdx
diff --git a/components/api.mdx b/components/api.mdx
diff --git a/components/card-group.mdx b/components/card-group.mdx
diff --git a/components/card.mdx b/components/card.mdx
diff --git a/components/cards.mdx b/components/cards.mdx
@@ -37,7 +37,7 @@
 
 Add an `img` property to display an image on the top of the card.
 
-<Card title="Image Card" img="https://mintlify-assets.b-cdn.net/yosemite.jpg">
+<Card title="Image Card" img="/images/yosemite.jpg">
   Here is an example of a card with an image
 </Card>
 
@@ -91,7 +91,7 @@
 </ResponseField>

 <ResponseField name="icon" type="string or svg">
  A [Font Awesome icon](https://fontawesome.com/icons), [Lucide
  icon](https://lucide.dev/icons), or JSX compatible SVG code in `icon={}`.

  To generate JSX compatible SVG code:

diff --git a/components/code-group.mdx b/components/code-group.mdx
diff --git a/components/code.mdx b/components/code.mdx
diff --git a/components/frame.mdx b/components/frame.mdx
diff --git a/components/parameter.mdx b/components/parameter.mdx
diff --git a/components/response-field.mdx b/components/response-field.mdx
diff --git a/components/tab-group.mdx b/components/tab-group.mdx
diff --git a/components/table.mdx b/components/table.mdx
diff --git a/components/tooltip.mdx b/components/tooltip.mdx
diff --git a/development.mdx b/development.mdx
diff --git a/essentials/code.mdx b/essentials/code.mdx
diff --git a/essentials/content.mdx b/essentials/content.mdx
diff --git a/essentials/images.mdx b/essentials/images.mdx
diff --git a/essentials/markdown.mdx b/essentials/markdown.mdx
diff --git a/essentials/navigation.mdx b/essentials/navigation.mdx
diff --git a/faqs.mdx b/faqs.mdx
diff --git a/getting-started.mdx b/getting-started.mdx
diff --git a/guides/assistant.mdx b/guides/assistant.mdx
@@ -5,14 +5,14 @@
 ---
 
 <Info>
-  The AI assistant is automatically enabled on [Pro, Growth, and Enterprise plans](https://mintlify.com/pricing?ref=assistant).
+  The AI assistant is automatically enabled on [Pro, Growth, and Enterprise plans](/pricing?ref=assistant).
 </Info>
 
 ## About the assistant

 The assistant answers questions about your documentation through natural language queries. It is embedded directly in your documentation site, providing users with immediate access to contextual help.

 The assistant uses agentic RAG (retrieval-augmented generation) with tool calling powered by Claude Sonnet 4. When users ask questions, the assistant:

 * **Searches and retrieves** relevant content from your documentation to provide accurate answers.
 * **Cites sources** and provides navigable links to take users directly to referenced pages.
@@ -28,7 +28,7 @@

 Users can access the assistant in two ways:

 - **Keyboard shortcut**: <kbd>Command</kbd> + <kbd>I</kbd> (<kbd>Ctrl</kbd> + <kbd>I</kbd> on Windows)
 - **Assistant button** next to the search bar
  <img
    src="/images/assistant/assistant-button-light.png"
@@ -51,7 +51,7 @@

 Both methods open a chat panel on the right side of your docs. Users can ask any question and the assistant will search your documentation for an answer. If no relevant information is found, the assistant will respond that it cannot answer the question.

 ## Making content AI ingestible

 Structure your documentation to help the assistant provide accurate, relevant answers. Clear organization and comprehensive context benefit both human readers and AI understanding.

@@ -60,7 +60,7 @@
  - Write descriptive headings for sections.
  - Create a logical information hierarchy.
  - Use consistent formatting across your docs.
  - Include comprehensive metadata in page frontmatter.
  - Break up long blocks of text into shorter paragraphs.
 </Card>


diff --git a/guides/custom-domain.mdx b/guides/custom-domain.mdx
diff --git a/guides/forms.mdx b/guides/forms.mdx
diff --git a/guides/i18n.mdx b/guides/i18n.mdx
diff --git a/guides/metadata.mdx b/guides/metadata.mdx
diff --git a/guides/node-api.mdx b/guides/node-api.mdx
diff --git a/guides/sdk-openapi.mdx b/guides/sdk-openapi.mdx
diff --git a/guides/search.mdx b/guides/search.mdx
diff --git a/guides/snippets.mdx b/guides/snippets.mdx
diff --git a/guides/sso.mdx b/guides/sso.mdx
diff --git a/guides/swagger.mdx b/guides/swagger.mdx
diff --git a/guides/teams.mdx b/guides/teams.mdx
diff --git a/guides/versioning.mdx b/guides/versioning.mdx
diff --git a/guides/webhook-proxy.mdx b/guides/webhook-proxy.mdx
diff --git a/hosting.mdx b/hosting.mdx
diff --git a/integrations/algolia.mdx b/integrations/algolia.mdx
diff --git a/integrations/checkly.mdx b/integrations/checkly.mdx
diff --git a/integrations/dark-mode.mdx b/integrations/dark-mode.mdx
diff --git a/integrations/fathom.mdx b/integrations/fathom.mdx
diff --git a/integrations/google-analytics.mdx b/integrations/google-analytics.mdx
diff --git a/integrations/sdks/speakeasy.mdx b/integrations/sdks/speakeasy.mdx
@@ -3,11 +3,11 @@
 description: Automate your SDK usage snippets in the API playground
 ---
 
-You can integrate Speakeasy-generated code snippets from your SDKs directly into your Mintlify API reference documentation. SDK usage snippets are shown in the [interactive playground](https://mintlify.com/docs/api-playground/overview) of your Mintlify-powered documentation.
+You can integrate Speakeasy-generated code snippets from your SDKs directly into your Mintlify API reference documentation. SDK usage snippets are shown in the [interactive playground](/api-playground/overview) of your Mintlify-powered documentation.
 
 ## Speakeasy SDK Repository Changes
 
 In your Speakeasy SDK repos, add the following to the `targets` section of your `.speakeasy/workflow.yaml` file to ensure code samples are automatically produced alongside SDK generations.

 ```yaml .speakeasy/workflow.yaml
 targets:
@@ -45,7 +45,7 @@

 ![](/images/speakeasy-3.webp)

 Finally, Add your `SPEAKEASY_API_KEY` as a repository secret to your Minlify repo under `Settings > Secrets & Variables > Actions`. Find the Speakeasy API key in the Speakeasy dashboard under the **API Keys** tab.

 ## Manual Set Up

@@ -94,4 +94,4 @@
      speakeasy_api_key: ${{ secrets.SPEAKEASY_API_KEY }}
 ```

 Finally, make sure you add your `SPEAKEASY_API_KEY` as a repository secret to your Minlify repo under `Settings > Secrets & Variables > Actions`. Find the Speakeasy API key in the Speakeasy dashboard under the **API Keys** tab.
diff --git a/navigation.mdx b/navigation.mdx
@@ -202,7 +202,7 @@ Anchors that strictly contain external links can be achieved using the `global`
       {
          "anchor": "Blog",
          "icon": "pencil",
-         "href": "https://mintlify.com/blog"
+         "href": "/blog"
       }
     ]
   },
@@ -487,7 +487,7 @@ This way, you can create a very complex navigation structure that is easy to man
           "anchors": [
             {
               "anchor": "Anchor 1",
-              "href": "https://mintlify.com/docs"
+              "href": "/docs"
             }
           ]
         },

diff --git a/settings.mdx b/settings.mdx
@@ -13,7 +13,7 @@

 To get started, you only need to specify `theme`, `name`, `colors.primary`, and `navigation`. Other fields are optional and you can add them as your documentation needs grow.

 For the best editing experience, include the schema reference at the top of your `docs.json` file. This enables autocomplete, validation, and helpful tooltips in most code editors:

 ```json
 {
@@ -41,7 +41,7 @@
 
 One of the following: `mint`, `maple`, `palm`, `willow`, `linden`, `almond`.
 
-See [Themes](themes) for more information.
+See [Themes](/customization/themes) for more information.
 
 </ResponseField>
 
@@ -158,7 +158,7 @@

  <Expandable title="Fonts">
    <ResponseField name="family" type="string" required>
      Font family, such as "Open Sans", "Playfair Display".
    </ResponseField>
    <ResponseField name="weight" type="number">
      Font weight, such as 400 or 700. Variable fonts support precise weights  such as 550.
@@ -263,12 +263,12 @@

 ### Structure

 <ResponseField name="navbar" type="object">
  Navigation bar items.

  <Expandable title="Navbar">
    <ResponseField name="links" type="array of object">
      Links to display in the navbar

      <Expandable title="Links">
        <ResponseField name="label" type="string" required>
@@ -306,7 +306,7 @@

  <Expandable title="Navigation">
    <ResponseField name="global" type="object">
      Global navigation elements that appear accross all pages and sections.

      <Expandable title="Global">
        <ResponseField name="languages" type="array of object">
@@ -540,7 +540,7 @@
  Contextual menu for AI-optimized content and integrations.

  <Expandable title="Contextual">
    <ResponseField name="options" type="array of &quot;copy&quot; | &quot;view&quot; | &quot;chatgpt&quot; | &quot;claude&quot;" required>
      Actions available in the contextual menu. The first option appears as the default.
      - `copy`: Copy the current page as Markdown to the clipboard.
      - `view`: View the current page as Markdown in a new tab.
@@ -559,7 +559,7 @@

 ### API Configurations

 <ResponseField name="api" type="object">
  API documentation and interactive playground settings.

  <Expandable title="Api">
@@ -978,7 +978,7 @@
      "footer": {
        "socials": {
          "x": "https://x.com/example",
          "linkedin": "https://www.linkedin.com/company/example",
          "github": "https://github.com/example",
          "slack": "https://example.com/community"
        },
@@ -1021,7 +1021,7 @@
      },
      "integrations": {
        "ga4": {
          "measurementId": "G-XXXXXXXXXX"
        },
        "koala": {
          "publicApiKey": "pk_example_key_123"
@@ -1030,8 +1030,8 @@
          "enabled": true
        },
        "cookies": {
          "key": "example_cookie_key",
          "value": "example_cookie_value"
        }
      },
      "contextual": {
@@ -1152,7 +1152,7 @@
      "footer": {
        "socials": {
          "x": "https://x.com/example",
          "linkedin": "https://www.linkedin.com/company/example",
          "github": "https://github.com/example",
          "slack": "https://example.com/community"
        },
@@ -1195,7 +1195,7 @@
      },
      "integrations": {
        "ga4": {
          "measurementId": "G-XXXXXXXXXX"
        },
        "koala": {
          "publicApiKey": "pk_example_key_123"
@@ -1204,8 +1204,8 @@
          "enabled": true
        },
        "cookies": {
          "key": "example_cookie_key",
          "value": "example_cookie_value"
        }
      },
      "contextual": {
@@ -1290,10 +1290,10 @@
              {
                "dropdown": "Documentación",
                "icon": "book",
                "description": "Cómo usar el producto de Example Co.",
                "pages": [
                  {
                    "group": "Comenzando",
                    "pages": ["es/index", "es/quickstart"]
                  },
                  {
@@ -1313,7 +1313,7 @@
              {
                "dropdown": "Changelog",
                "icon": "history",
                "description": "Actualizaciones y cambios",
                "pages": ["es/changelog"]
              }
            ]
@@ -1341,7 +1341,7 @@
      "footer": {
        "socials": {
          "x": "https://x.com/example",
          "linkedin": "https://www.linkedin.com/company/example",
          "github": "https://github.com/example",
          "slack": "https://example.com/community"
        },
@@ -1384,7 +1384,7 @@
      },
      "integrations": {
        "ga4": {
          "measurementId": "G-XXXXXXXXXX"
        },
        "koala": {
          "publicApiKey": "pk_example_key_123"
@@ -1393,8 +1393,8 @@
          "enabled": true
        },
        "cookies": {
          "key": "example_cookie_key",
          "value": "example_cookie_value"
        }
      },
      "contextual": {