mintlify · ethanpalm · Sep 14, 2026 · Sep 1, 2026 · Sep 1, 2026 · Sep 2, 2026
diff --git a/analytics/traffic.mdx b/analytics/traffic.mdx
@@ -2,9 +2,17 @@
 title: "Analyze documentation traffic"
 sidebarTitle: "Traffic"
 description: "Review traffic analytics to track visitors, page views, referrals, popular pages, and traffic from both human readers and AI agents."
-keywords: ["analytics", "traffic", "page views", "visitors", "referrals", "agent views"]
+keywords:
+  - "analytics"
+  - "traffic"
+  - "page views"
+  - "visitors"
+  - "referrals"
+  - "agent views"
 ---
 
+/
+
 <Info>
   Analytics require a [Pro or Enterprise plan](https://mintlify.com/pricing?ref=analytics).
 </Info>
@@ -19,18 +27,25 @@
 
 <Frame>
   <img
-    src="/images/analytics/traffic-light.png"
     alt="The Traffic view of the analytics page."
     className="block dark:hidden"
+    src="/images/analytics/traffic-light.png"
   />
-
   <img
-    src="/images/analytics/traffic-dark.png"
     alt="The Traffic view of the analytics page."
     className="hidden dark:block"
+    src="/images/analytics/traffic-dark.png"
   />
 </Frame>
 
+## How Mintlify counts traffic
+
+Mintlify classifies every request by user agent and counts only human and agent traffic toward visitor and page view totals. Traffic from search indexing crawlers, AI training crawlers, and other bots is excluded from both metrics. For a breakdown of each traffic category, see [Interpret traffic exports](/analytics/export#interpret-traffic-exports).
+
+<Note>
+  In September 2026, Mintlify updated visitor counts to use the same crawler filtering as page views. Visitor totals dropped on most sites, and the change applies to all date ranges. See [Why your visitor count dropped after crawler filtering](/help-center/visitor-count-dropped-after-crawler-filtering).
+</Note>
+
 ## Interpret agent views
 
 Mintlify identifies agent visitors by IP address and user agent. The agent visitor count approximates distinct sources of AI traffic rather than individual agent sessions or conversations. Multiple requests from the same IP address count as one visitor.
@@ -46,3 +61,11 @@
 - **AI agent distribution**: See which AI platforms access your docs to learn which tools your users prefer.
 - **Integration opportunities**: Identify which AI platforms to prioritize for optimization and testing.
 - **AI traffic patterns**: Monitor which agents are most active and how their usage changes over time.
+
+The agent breakdown groups traffic by provider, such as ChatGPT, Claude, and Cursor. Three buckets capture the remaining agent traffic:
+
+- **HTTP clients**: Requests from tools and libraries such as curl, wget, and Python HTTP clients.
+- **Browser**: Markdown requests made from a web browser.
+- **Other**: Agent traffic that does not match a known provider or client.
+
+Mintlify excludes its own internal traffic, such as link checking and page revalidation, from the agent breakdown.
diff --git a/docs.json b/docs.json
@@ -488,7 +488,8 @@
                   "help-center/preview-deployment-not-created-for-fork-branch",
                   "help-center/branch-missing-from-editor-branch-list",
                   "help-center/style-card-icons-with-custom-css",
-                  "help-center/can-i-rename-my-deployment-or-organization"
+                  "help-center/can-i-rename-my-deployment-or-organization",
+                  "help-center/visitor-count-dropped-after-crawler-filtering"
                 ]
               }
             ]

diff --git a/es.json b/es.json
@@ -465,7 +465,8 @@
             "es/help-center/static-file-not-served",
             "es/help-center/preview-deployment-not-created-for-fork-branch",
             "es/help-center/style-card-icons-with-custom-css",
-            "es/help-center/can-i-rename-my-deployment-or-organization"
+            "es/help-center/can-i-rename-my-deployment-or-organization",
+            "es/help-center/visitor-count-dropped-after-crawler-filtering"
           ]
         }
       ]

diff --git a/es/analytics/traffic.mdx b/es/analytics/traffic.mdx
@@ -31,6 +31,16 @@ Revisa las analíticas de tráfico para:
   />
 </Frame>
 
+<div id="how-mintlify-counts-traffic">
+  ## Cómo cuenta Mintlify el tráfico
+</div>
+
+Mintlify clasifica cada solicitud según el user agent y solo cuenta el tráfico humano y de agentes en los totales de visitantes y de vistas de página. El tráfico de rastreadores de indexación de búsqueda, rastreadores de entrenamiento de IA y otros bots se excluye de ambas métricas. Para ver el desglose de cada categoría de tráfico, consulta [Interpretar las exportaciones de tráfico](/es/analytics/export#interpret-traffic-exports).
+
+<Note>
+  En septiembre de 2026, Mintlify actualizó los conteos de visitantes para usar el mismo filtrado de rastreadores que las vistas de página. Los totales de visitantes bajaron en la mayoría de los sitios, y el cambio se aplica a todos los rangos de fechas. Consulta [Por qué bajó tu conteo de visitantes tras el filtrado de rastreadores](/es/help-center/visitor-count-dropped-after-crawler-filtering).
+</Note>
+
 <div id="interpret-agent-views">
   ## Interpretar las vistas de agentes
 </div>
@@ -48,3 +58,11 @@ Usa las vistas de agentes para comprender:
 - **Distribución de agentes de IA**: Observa qué plataformas de IA acceden a tus docs para saber qué herramientas prefieren tus usuarios.
 - **Oportunidades de integración**: Identifica qué plataformas de IA priorizar para la optimización y las pruebas.
 - **Patrones de tráfico de IA**: Monitorea qué agentes son más activos y cómo cambia su uso a lo largo del tiempo.
+
+El desglose de agentes agrupa el tráfico por proveedor, como ChatGPT, Claude y Cursor. Tres categorías capturan el resto del tráfico de agentes:
+
+- **HTTP clients**: Solicitudes de herramientas y bibliotecas como curl, wget y clientes HTTP de Python.
+- **Browser**: Solicitudes de Markdown realizadas desde un navegador web.
+- **Other**: Tráfico de agentes que no coincide con un proveedor o cliente conocido.
+
+Mintlify excluye su propio tráfico interno, como la verificación de enlaces y la revalidación de páginas, del desglose de agentes.
diff --git a/es/help-center/visitor-count-dropped-after-crawler-filtering.mdx b/es/help-center/visitor-count-dropped-after-crawler-filtering.mdx
@@ -0,0 +1,26 @@
+---
+title: "Por qué bajó tu conteo de visitantes tras el filtrado de rastreadores"
+description: "Comprende por qué los totales de visitantes en las analíticas de Mintlify bajaron en septiembre de 2026, cuando el tráfico de rastreadores se excluyó de los conteos de visitantes."
+keywords: ["visitor count dropped", "visitors lower than views", "more visitors than views", "crawler traffic", "bot filtering", "analytics visitors"]
+---
+
+En septiembre de 2026, Mintlify cambió la forma en que el panel de analíticas cuenta los visitantes únicos. Los totales de visitantes ahora excluyen el tráfico de rastreadores de indexación de búsqueda, rastreadores de entrenamiento de IA y otros bots, igualando el filtrado que ya se aplicaba a las vistas de página. Si tu conteo de visitantes bajó bruscamente, o los números históricos se ven más bajos que antes, este cambio es la causa más probable.
+
+<div id="what-changed">
+  ## Qué cambió
+</div>
+
+Antes de esta actualización, el tráfico de rastreadores se excluía de los conteos de vistas de página, pero no de los conteos de visitantes. Los rastreadores inflan los totales de visitantes mucho más que los de vistas porque no conservan cookies, por lo que Mintlify no puede reconocer solicitudes repetidas del mismo rastreador como un solo visitante. En sitios con mucho tráfico de rastreadores, esta inflación podía llevar el conteo de visitantes por encima del conteo de vistas de página, algo imposible con tráfico real de lectores.
+
+Los conteos de visitantes ahora usan la misma clasificación de rastreadores que las vistas de página. Solo los lectores humanos y los agentes de IA cuentan en los totales de visitantes.
+
+<div id="what-to-expect">
+  ## Qué esperar
+</div>
+
+- Los totales de visitantes son más bajos en la mayoría de los sitios. Los sitios que reciben mucho tráfico de rastreadores muestran la mayor caída.
+- El cambio se aplica a todos los rangos de fechas, incluidos los históricos, porque Mintlify clasifica el tráfico al calcular el informe y no al almacenar los eventos.
+- Las vistas por visitante vuelven a una proporción plausible, con más vistas de página que visitantes.
+- Los totales de visitantes agentes también pueden cambiar, porque la misma actualización refinó cómo se identifica el tráfico de agentes.
+
+Para saber cómo clasifica Mintlify el tráfico y cómo interpretar las vistas de agentes, consulta [Analizar el tráfico de la documentación](/es/analytics/traffic).
diff --git a/fr.json b/fr.json
@@ -465,7 +465,8 @@
             "fr/help-center/static-file-not-served",
             "fr/help-center/preview-deployment-not-created-for-fork-branch",
             "fr/help-center/style-card-icons-with-custom-css",
-            "fr/help-center/can-i-rename-my-deployment-or-organization"
+            "fr/help-center/can-i-rename-my-deployment-or-organization",
+            "fr/help-center/visitor-count-dropped-after-crawler-filtering"
           ]
         }
       ]

diff --git a/fr/analytics/traffic.mdx b/fr/analytics/traffic.mdx
@@ -31,6 +31,16 @@ Consultez les analytics de trafic pour :
   />
 </Frame>
 
+<div id="how-mintlify-counts-traffic">
+  ## Comment Mintlify comptabilise le trafic
+</div>
+
+Mintlify classe chaque requête selon son user agent et ne comptabilise que le trafic humain et le trafic des agents dans les totaux de visiteurs et de pages vues. Le trafic des robots d'indexation de recherche, des robots d'entraînement d'IA et des autres bots est exclu des deux métriques. Pour le détail de chaque catégorie de trafic, consultez [Interpréter les exports de trafic](/fr/analytics/export#interpret-traffic-exports).
+
+<Note>
+  En septembre 2026, Mintlify a mis à jour le comptage des visiteurs pour utiliser le même filtrage des robots que les pages vues. Les totaux de visiteurs ont baissé sur la plupart des sites, et le changement s'applique à toutes les plages de dates. Consultez [Pourquoi votre nombre de visiteurs a baissé après le filtrage des robots](/fr/help-center/visitor-count-dropped-after-crawler-filtering).
+</Note>
+
 <div id="interpret-agent-views">
   ## Interpréter les vues des agents
 </div>
@@ -48,3 +58,11 @@ Utilisez les vues des agents pour comprendre :
 - **La distribution des agents IA** : Voyez quelles plateformes IA accèdent à vos docs pour savoir quels outils vos utilisateurs préfèrent.
 - **Les opportunités d'intégration** : Identifiez les plateformes IA à prioriser pour l'optimisation et les tests.
 - **Les schémas du trafic IA** : Surveillez quels agents sont les plus actifs et comment leur utilisation évolue dans le temps.
+
+La répartition des agents regroupe le trafic par fournisseur, comme ChatGPT, Claude et Cursor. Trois catégories regroupent le reste du trafic des agents :
+
+- **HTTP clients** : Requêtes provenant d'outils et de bibliothèques comme curl, wget et les clients HTTP Python.
+- **Browser** : Requêtes Markdown effectuées depuis un navigateur web.
+- **Other** : Trafic d'agents qui ne correspond à aucun fournisseur ou client connu.
+
+Mintlify exclut son propre trafic interne, comme la vérification des liens et la revalidation des pages, de la répartition des agents.
diff --git a/fr/help-center/visitor-count-dropped-after-crawler-filtering.mdx b/fr/help-center/visitor-count-dropped-after-crawler-filtering.mdx
@@ -0,0 +1,26 @@
+---
+title: "Pourquoi votre nombre de visiteurs a baissé après le filtrage des robots"
+description: "Comprenez pourquoi les totaux de visiteurs dans les analytics Mintlify ont baissé en septembre 2026, lorsque le trafic des robots a été exclu du comptage des visiteurs."
+keywords: ["visitor count dropped", "visitors lower than views", "more visitors than views", "crawler traffic", "bot filtering", "analytics visitors"]
+---
+
+En septembre 2026, Mintlify a changé la façon dont le tableau de bord analytics compte les visiteurs uniques. Les totaux de visiteurs excluent désormais le trafic des robots d'indexation de recherche, des robots d'entraînement d'IA et des autres bots, en appliquant le même filtrage que celui déjà utilisé pour les pages vues. Si votre nombre de visiteurs a chuté brusquement, ou si les chiffres historiques semblent plus bas qu'avant, ce changement en est la cause la plus probable.
+
+<div id="what-changed">
+  ## Ce qui a changé
+</div>
+
+Avant cette mise à jour, le trafic des robots était exclu du comptage des pages vues, mais pas du comptage des visiteurs. Les robots gonflent les totaux de visiteurs bien plus que ceux des vues, car ils ne conservent pas les cookies. Mintlify ne peut donc pas reconnaître les requêtes répétées d'un même robot comme un seul visiteur. Sur les sites avec un trafic de robots important, cette inflation pouvait faire passer le nombre de visiteurs au-dessus du nombre de pages vues, ce qui est impossible avec du trafic de lecteurs réels.
+
+Le comptage des visiteurs utilise désormais la même classification des robots que les pages vues. Seuls les lecteurs humains et les agents IA comptent dans les totaux de visiteurs.
+
+<div id="what-to-expect">
+  ## À quoi s'attendre
+</div>
+
+- Les totaux de visiteurs sont plus bas sur la plupart des sites. Les sites recevant un trafic de robots important affichent la plus forte baisse.
+- Le changement s'applique à toutes les plages de dates, y compris historiques, car Mintlify classe le trafic au moment de calculer le rapport et non au moment de stocker les événements.
+- Le ratio de vues par visiteur redevient plausible, avec plus de pages vues que de visiteurs.
+- Les totaux de visiteurs agents peuvent aussi évoluer, car la même mise à jour a affiné l'identification du trafic des agents.
+
+Pour comprendre comment Mintlify classe le trafic et comment interpréter les vues des agents, consultez [Analyser le trafic de la documentation](/fr/analytics/traffic).
diff --git a/help-center/visitor-count-dropped-after-crawler-filtering.mdx b/help-center/visitor-count-dropped-after-crawler-filtering.mdx
@@ -0,0 +1,22 @@
+---
+title: "Why your visitor count dropped after crawler filtering"
+description: "Understand why visitor totals in Mintlify analytics dropped in September 2026 after crawler traffic was excluded from visitor counts."
+keywords: ["visitor count dropped", "visitors lower than views", "more visitors than views", "crawler traffic", "bot filtering", "analytics visitors"]
+---
+
+In September 2026, Mintlify changed how the analytics dashboard counts unique visitors. Visitor totals now exclude traffic from search indexing crawlers, AI training crawlers, and other bots, matching the filtering that already applied to page views. If your visitor count dropped sharply, or historical numbers look lower than they did before, this change is the most likely cause.
+
+## What changed
+
+Before this update, crawler traffic was excluded from page view counts but not from visitor counts. Crawlers inflate visitor totals far more than view totals because they do not persist cookies, so Mintlify cannot recognize repeat requests from the same crawler as one visitor. On sites with heavy crawler traffic, this inflation could push the visitor count above the page view count, which is impossible for real reader traffic.
+
+Visitor counts now use the same crawler classification as page views. Only human readers and AI agents count toward visitor totals.
+
+## What to expect
+
+- Visitor totals are lower on most sites. Sites that receive heavy crawler traffic see the largest drop.
+- The change applies to every date range, including historical ones, because Mintlify classifies traffic when it computes the report rather than when it stores events.
+- Views per visitor returns to a plausible ratio, with more page views than visitors.
+- Agent visitor totals can also shift, because the same update refined how agent traffic is identified.
+
+For how Mintlify classifies traffic and how to interpret agent views, see [Analyze documentation traffic](/analytics/traffic).
diff --git a/zh.json b/zh.json
@@ -465,7 +465,8 @@
             "zh/help-center/static-file-not-served",
             "zh/help-center/preview-deployment-not-created-for-fork-branch",
             "zh/help-center/style-card-icons-with-custom-css",
-            "zh/help-center/can-i-rename-my-deployment-or-organization"
+            "zh/help-center/can-i-rename-my-deployment-or-organization",
+            "zh/help-center/visitor-count-dropped-after-crawler-filtering"
           ]
         }
       ]

diff --git a/zh/analytics/traffic.mdx b/zh/analytics/traffic.mdx
@@ -31,6 +31,16 @@ keywords: ["analytics", "traffic", "page views", "visitors", "referrals", "agent
   />
 </Frame>
 
+<div id="how-mintlify-counts-traffic">
+  ## Mintlify 如何统计流量
+</div>
+
+Mintlify 根据 user agent 对每个请求进行分类,只有人类流量和 agent 流量会计入访客数和页面浏览量总数。搜索索引爬虫、AI 训练爬虫和其他 bot 的流量不计入这两项指标。有关各流量类别的详细说明,请参阅[解读流量导出](/zh/analytics/export#interpret-traffic-exports)。
+
+<Note>
+  2026 年 9 月,Mintlify 更新了访客统计方式,使其采用与页面浏览量相同的爬虫过滤规则。大多数站点的访客总数因此下降,且该变更适用于所有日期范围。请参阅[为什么爬虫过滤后访客数下降了](/zh/help-center/visitor-count-dropped-after-crawler-filtering)。
+</Note>
+
 <div id="interpret-agent-views">
   ## 解读 agent 浏览量
 </div>
@@ -48,3 +58,11 @@ Mintlify 通过 IP 地址和 user agent 识别 agent 访客。agent 访客数近
 - **AI agent 分布**:查看哪些 AI 平台访问您的 docs,了解用户偏好哪些工具。
 - **集成机会**:识别哪些 AI 平台应优先进行优化和测试。
 - **AI 流量模式**:监控哪些 agent 最活跃,以及它们的使用情况如何随时间变化。
+
+agent 明细按提供商对流量进行分组,例如 ChatGPT、Claude 和 Cursor。其余的 agent 流量归入三个类别:
+
+- **HTTP clients**:来自 curl、wget 和 Python HTTP 客户端等工具和库的请求。
+- **Browser**:从 Web 浏览器发出的 Markdown 请求。
+- **Other**:与已知提供商或客户端不匹配的 agent 流量。
+
+Mintlify 会从 agent 明细中排除自身的内部流量,例如链接检查和页面重新验证。
diff --git a/zh/help-center/visitor-count-dropped-after-crawler-filtering.mdx b/zh/help-center/visitor-count-dropped-after-crawler-filtering.mdx
@@ -0,0 +1,26 @@
+---
+title: "为什么爬虫过滤后访客数下降了"
+description: "了解为什么 Mintlify 分析中的访客总数在 2026 年 9 月下降:爬虫流量已从访客统计中排除,与页面浏览量的过滤规则保持一致。"
+keywords: ["visitor count dropped", "visitors lower than views", "more visitors than views", "crawler traffic", "bot filtering", "analytics visitors"]
+---
+
+2026 年 9 月,Mintlify 更改了分析仪表板统计独立访客的方式。访客总数现在会排除搜索索引爬虫、AI 训练爬虫和其他 bot 的流量,与页面浏览量已有的过滤规则保持一致。如果您的访客数骤降,或历史数据看起来比以前低,此变更是最可能的原因。
+
+<div id="what-changed">
+  ## 变更内容
+</div>
+
+在此更新之前,爬虫流量已从页面浏览量统计中排除,但未从访客统计中排除。爬虫对访客总数的夸大程度远高于浏览量,因为爬虫不保留 cookie,Mintlify 无法将同一爬虫的重复请求识别为同一个访客。在爬虫流量较大的站点上,这种夸大可能使访客数超过页面浏览量,而真实读者流量不可能出现这种情况。
+
+访客统计现在使用与页面浏览量相同的爬虫分类。只有人类读者和 AI agent 会计入访客总数。
+
+<div id="what-to-expect">
+  ## 预期变化
+</div>
+
+- 大多数站点的访客总数会降低。爬虫流量较大的站点降幅最大。
+- 该变更适用于所有日期范围,包括历史范围,因为 Mintlify 在生成报表时对流量进行分类,而不是在存储事件时分类。
+- 每位访客的浏览量恢复到合理比例,页面浏览量多于访客数。
+- agent 访客总数也可能变化,因为同一更新优化了 agent 流量的识别方式。
+
+要了解 Mintlify 如何对流量分类以及如何解读 agent 浏览量,请参阅[分析文档流量](/zh/analytics/traffic)。