mintlify · ethanpalm · Aug 17, 2026 · Aug 16, 2026 · Aug 16, 2026 · Aug 17, 2026
diff --git a/assistant/widget.mdx b/assistant/widget.mdx
@@ -10,7 +10,7 @@

 export const WidgetCodeBlock = ({ children, ...props }) => (
  <CodeBlock {...props}>{children}</CodeBlock>
 );

 The [assistant](/assistant) answers questions on your Mintlify site. To embed the same capability on another site or web app, use the widget. The widget gives your users access to AI chat trained on your content, wherever they use your product. Embed it in your dashboard, marketing site, support portal, or elsewhere.

@@ -180,6 +180,7 @@
 | `starterQuestions` | string[]                                        | Sets up to three empty-state prompts for this embed.                              |
 | `filter`           | [`AssistantFilter`](#assistantfilter)           | Restricts retrieval to a docs language and version.                          |
 | `hooks`            | [`AssistantHooks`](#assistanthooks)             | Event and error observers.                                                   |
+| `analytics`        | [`AssistantAnalyticsConfig`](#assistantanalyticsconfig) | Internal widget analytics settings.                                  |
 
 ### `AssistantAppearance`
 
@@ -205,6 +206,12 @@
 | `language` | string or `null` | Restricts retrieval to a [supported language code](/organize/settings-reference#navigation-global-languages), such as `en`. Omit to search all languages. |
 | `version`  | string or `null` | Restricts retrieval to a docs version, such as `v2`. Omit to search all versions.                                                                  |
 
+### `AssistantAnalyticsConfig`
+
+| Option             | Type    | Description                                                                                                                     |
+| ------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| `capturePathname`  | boolean | Includes the embedding page's current pathname in internal widget analytics events. The default is `true`. Set to `false` to opt out. |
+
 ### `AssistantLabels`
 
 | Option        | Values            | Description                                                         |
@@ -279,7 +286,7 @@

 Conversation snapshots remain private to the widget. Each method resolves to `void`.

 ## Content Security Policy

 If your site uses a Content Security Policy, allow the origins required by your enabled widget features:

@@ -290,9 +297,9 @@
 | `connect-src`                                | `https://api.mintlify.com`          | Configuration, messages, and feedback |
 | `connect-src`                                | `https://ph.mintlify.com`           | Internal widget analytics             |
 | `font-src`                                   | `https://widget.mintlify.com`       | Optional bundled Inter font           |
 | `script-src`, `connect-src`, and `frame-src` | `https://challenges.cloudflare.com` | Turnstile bot protection              |
 | `script-src`                                 | `https://js.hcaptcha.com`           | hCaptcha bot protection               |
 | `connect-src` and `frame-src`                | `https://*.hcaptcha.com`            | hCaptcha bot protection               |

 A strict `script-src` policy must still authorize both the loader and initialization script. A strict `style-src` policy must authorize the nonce you pass to `init()`, which the widget copies to its injected style sheet. Passing `nonce` to `init()` propagates it only to resources the widget creates after initialization.


diff --git a/es/assistant/widget.mdx b/es/assistant/widget.mdx
@@ -198,6 +198,7 @@ Pasa este objeto a `init()`.
 | `starterQuestions` | string[]                                        | Establece hasta **tres** sugerencias de estado vacío para este embed.        |
 | `filter`           | [`AssistantFilter`](#assistantfilter)           | Restringe la recuperación a un idioma y versión de la documentación.         |
 | `hooks`            | [`AssistantHooks`](#assistanthooks)             | Observadores de eventos y errores.                                           |
+| `analytics`        | [`AssistantAnalyticsConfig`](#assistantanalyticsconfig) | Configuración de la analítica interna del widget.                    |
 
 <div id="assistantappearance">
   ### `AssistantAppearance`
@@ -227,6 +228,14 @@ No se admiten sobrescrituras arbitrarias de CSS ni de paleta neutra. El Shadow D
 | `language` | string or `null` | Restringe la recuperación a un [código de idioma admitido](/es/organize/settings-reference#navigation-global-languages), como `en`. Omítelo para buscar en todos los idiomas. |
 | `version`  | string or `null` | Restringe la recuperación a una versión de la documentación, como `v2`. Omítela para buscar en todas las versiones.                                            |
 
+<div id="assistantanalyticsconfig">
+  ### `AssistantAnalyticsConfig`
+</div>
+
+| Option             | Type    | Description                                                                                                                                       |
+| ------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `capturePathname`  | boolean | Incluye la ruta actual de la página que incrusta el widget en los eventos internos de analítica. El valor por defecto es `true`. Establécelo en `false` para desactivarlo. |
+
 <div id="assistantlabels">
   ### `AssistantLabels`
 </div>

diff --git a/fr/assistant/widget.mdx b/fr/assistant/widget.mdx
@@ -198,6 +198,7 @@ Passez cet objet à `init()`.
 | `starterQuestions` | string[]                                        | Définit jusqu'à **trois** invites d'état vide pour cette intégration.         |
 | `filter`           | [`AssistantFilter`](#assistantfilter)           | Restreint la recherche à une langue et à une version de la documentation.    |
 | `hooks`            | [`AssistantHooks`](#assistanthooks)             | Observateurs d'événements et d'erreurs.                                       |
+| `analytics`        | [`AssistantAnalyticsConfig`](#assistantanalyticsconfig) | Paramètres des analyses internes du widget.                        |
 
 <div id="assistantappearance">
   ### `AssistantAppearance`
@@ -227,6 +228,14 @@ Les substitutions CSS arbitraires et les palettes neutres ne sont pas prises en
 | `language` | string or `null` | Restreint la recherche à un [code de langue pris en charge](/fr/organize/settings-reference#navigation-global-languages), tel que `en`. Omettez pour rechercher dans toutes les langues. |
 | `version`  | string or `null` | Restreint la recherche à une version de la documentation, telle que `v2`. Omettez pour rechercher dans toutes les versions.                                       |
 
+<div id="assistantanalyticsconfig">
+  ### `AssistantAnalyticsConfig`
+</div>
+
+| Option             | Type    | Description                                                                                                                                          |
+| ------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `capturePathname`  | boolean | Inclut le chemin actuel de la page qui intègre le widget dans les événements d'analyse internes. La valeur par défaut est `true`. Définissez-le sur `false` pour ne pas participer. |
+
 <div id="assistantlabels">
   ### `AssistantLabels`
 </div>

diff --git a/zh/assistant/widget.mdx b/zh/assistant/widget.mdx
@@ -198,6 +198,7 @@ await window.MintlifyAssistant.update({
 | `starterQuestions` | string[]                                        | 为该嵌入设置最多 **三** 条空状态提示。                                       |
 | `filter`           | [`AssistantFilter`](#assistantfilter)           | 将检索限定到指定的文档语言和版本。                                           |
 | `hooks`            | [`AssistantHooks`](#assistanthooks)             | 事件和错误观察者。                                                           |
+| `analytics`        | [`AssistantAnalyticsConfig`](#assistantanalyticsconfig) | 内部小组件分析设置。                                                    |
 
 <div id="assistantappearance">
   ### `AssistantAppearance`
@@ -227,6 +228,14 @@ await window.MintlifyAssistant.update({
 | `language` | string or `null` | 将检索限定到[受支持的语言代码](/zh/organize/settings-reference#navigation-global-languages),例如 `en`。省略以在所有语言中检索。       |
 | `version`  | string or `null` | 将检索限定到指定的文档版本,例如 `v2`。省略以在所有版本中检索。                                                                    |
 
+<div id="assistantanalyticsconfig">
+  ### `AssistantAnalyticsConfig`
+</div>
+
+| Option             | Type    | Description                                                                                                             |
+| ------------------ | ------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `capturePathname`  | boolean | 在内部小组件分析事件中包含嵌入页面的当前路径。默认值为 `true`。设置为 `false` 可选择停用。                              |
+
 <div id="assistantlabels">
   ### `AssistantLabels`
 </div>