Skip to content

Commit e5d1791

Browse files
docs: remove mint analytics CLI command (#6221)
* docs: remove mint analytics CLI command * docs: tighten CLI page descriptions for SEO * Apply suggestion from @ethanpalm * clean up redirects.json --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
1 parent 118acbe commit e5d1791

29 files changed

Lines changed: 41 additions & 1101 deletions

changelog.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -387,7 +387,7 @@ noindex: true
387387
<Update label="April 10, 2026" tags={["New releases","Improvements"]} rss={{ title:"CLI analytics, directory listings, multi-skill support, Slack bot improvements, and more" }}>
388388
## CLI analytics
389389

390-
The [`mint analytics`](/cli/analytics) command lets you view traffic, search queries, user feedback, and assistant conversations from the terminal for better integration with agents.
390+
The `mint analytics` command lets you view traffic, search queries, user feedback, and assistant conversations from the terminal for better integration with agents.
391391

392392
Use subcommands to explore specific data:
393393

cli/analytics.mdx

Lines changed: 0 additions & 130 deletions
This file was deleted.

cli/commands.mdx

Lines changed: 2 additions & 105 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Commands"
3-
description: "Complete reference for every Mintlify CLI command and flag, including mint dev, mint build, mint validate, mint analytics, and more."
3+
description: "Complete reference for every Mintlify CLI command and flag, including mint dev, mint build, mint validate, mint broken-links, and more."
44
keywords: ["CLI", "mint", "commands", "flags", "reference"]
55
boost: 3
66
---
@@ -67,107 +67,6 @@ mint status
6767

6868
---
6969

70-
## `mint analytics`
71-
72-
View analytics data for your documentation. Requires authentication with `mint login`.
73-
74-
```bash
75-
mint analytics <subcommand> [flags]
76-
```
77-
78-
All subcommands accept these shared flags:
79-
80-
| Flag | Description |
81-
| --- | --- |
82-
| `--subdomain` | Documentation subdomain. Defaults to the value set with `mint config set subdomain`, or the first project on your account. |
83-
| `--from` | Start date in `YYYY-MM-DD` format. Defaults to 7 days ago, or the value set with `mint config set dateFrom`. |
84-
| `--to` | End date in `YYYY-MM-DD` format. Defaults to today, or the value set with `mint config set dateTo`. |
85-
| `--format` | Output format: `plain` (default), `table`, `json`, or `graph`. |
86-
87-
### `mint analytics stats`
88-
89-
Display a summary of views, visitors, searches, feedback, and assistant usage.
90-
91-
```bash
92-
mint analytics stats [flags]
93-
```
94-
95-
| Flag | Description |
96-
| --- | --- |
97-
| `--page` | Filter to a specific page path. |
98-
99-
### `mint analytics search`
100-
101-
Display search queries with hit counts and click-through rates.
102-
103-
```bash
104-
mint analytics search [flags]
105-
```
106-
107-
| Flag | Description |
108-
| --- | --- |
109-
| `--query` | Filter by search query substring. |
110-
| `--page` | Filter by top clicked page. |
111-
112-
### `mint analytics feedback`
113-
114-
Display feedback submitted by users.
115-
116-
```bash
117-
mint analytics feedback [flags]
118-
```
119-
120-
| Flag | Description |
121-
| --- | --- |
122-
| `--type` | Feedback type: `page` (aggregate by page) or `code` (code snippet feedback). |
123-
| `--page` | Filter to a specific page path. |
124-
125-
### `mint analytics conversation`
126-
127-
View assistant conversation data.
128-
129-
```bash
130-
mint analytics conversation <subcommand> [flags]
131-
```
132-
133-
#### `mint analytics conversation list`
134-
135-
List assistant conversations. Each entry includes a conversation ID.
136-
137-
```bash
138-
mint analytics conversation list [flags]
139-
```
140-
141-
| Flag | Description |
142-
| --- | --- |
143-
| `--page` | Filter conversations that reference a specific page in sources. |
144-
145-
#### `mint analytics conversation view <conversation-id>`
146-
147-
View a single conversation by ID. Use `mint analytics conversation list` to get IDs.
148-
149-
```bash
150-
mint analytics conversation view <conversation-id>
151-
```
152-
153-
#### `mint analytics conversation buckets list`
154-
155-
List grouped conversation categories. Each entry includes a bucket ID.
156-
157-
```bash
158-
mint analytics conversation buckets list
159-
```
160-
161-
#### `mint analytics conversation buckets view <bucket-id>`
162-
163-
View conversations in a category bucket. Use `mint analytics conversation buckets list` to get IDs.
164-
165-
```bash
166-
mint analytics conversation buckets view <bucket-id>
167-
```
168-
169-
---
170-
17170
## `mint workflow`
17271

17372
Create, list, and delete [workflows](/workflows) from the terminal. Requires authentication with `mint login`.
@@ -282,9 +181,7 @@ mint config <subcommand> <key> [value]
282181

283182
| Key | Description | Used by |
284183
| --- | --- | --- |
285-
| `subdomain` | Default documentation subdomain. | `mint analytics`, `mint workflow` |
286-
| `dateFrom` | Default start date for analytics queries (`YYYY-MM-DD`). | `mint analytics` |
287-
| `dateTo` | Default end date for analytics queries (`YYYY-MM-DD`). | `mint analytics` |
184+
| `subdomain` | Default documentation subdomain. | `mint workflow` |
288185

289186
---
290187

cli/index.mdx

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Mintlify CLI"
3-
description: "Use the Mintlify CLI to preview docs locally, test changes in real time, analyze site performance, and run quality checks before deploying."
4-
keywords: ["CLI", "mint", "local development", "preview", "analytics"]
3+
description: "Use the Mintlify CLI to preview docs locally, test changes in real time, and run accessibility, link, and validation checks before deploying."
4+
keywords: ["CLI", "mint", "local development", "preview"]
55
---
66

77
import SkillMcpPrompt from "/snippets/skill-mcp-prompt.mdx";
@@ -19,24 +19,21 @@ import SkillMcpPrompt from "/snippets/skill-mcp-prompt.mdx";
1919

2020
## About the CLI
2121

22-
Use the [CLI](https://www.npmjs.com/package/mint) to preview your documentation locally, test changes in real time, analyze site performance, and run quality checks before deploying to production.
22+
Use the [CLI](https://www.npmjs.com/package/mint) to preview your documentation locally, test changes in real time, and run quality checks before deploying to production.
2323

2424
The CLI runs on your machine and connects to your Mintlify deployment when you need live data.
2525

2626
### Preview locally
2727
Run `mint dev` to preview your documentation at `localhost:3000`. As you write and update your content, changes appear in real time without deploying. Log in to enable search and the AI assistant in your local preview.
2828

29-
### Analyze your documentation
30-
Run `mint analytics` to view traffic, search queries, user feedback, and AI assistant conversations directly from the terminal. Useful for quick checks, scripting, and piping data into other tools.
31-
3229
### Run quality checks
3330
Run `mint broken-links` to find broken links, `mint a11y` to check accessibility, and `mint validate` to validate your documentation build before it reaches production.
3431

3532
### Check agent readiness
3633
Run `mint score` to evaluate how well agents can navigate a documentation site. With no arguments, the command scores your configured subdomain. Pass a URL to score any other site. The command displays an overall readiness score and individual check results.
3734

3835
### Manage configuration
39-
Run `mint config` to set persistent defaults like your documentation subdomain and date ranges for analytics commands.
36+
Run `mint config` to set persistent defaults like your documentation subdomain.
4037

4138
<Tip>
4239
Working on your docs locally with an AI coding tool? Install the Mintlify [skill](/ai/skillmd) and [MCP server](/ai/model-context-protocol) so your editor has the context it needs to write Mintlify-aware content.
@@ -48,5 +45,4 @@ Run `mint config` to set persistent defaults like your documentation subdomain a
4845

4946
- [Install the CLI](/cli/install): Get the CLI installed and ready to use.
5047
- [Preview locally](/cli/preview): Run a local development server with search and assistant support.
51-
- [Analyze your documentation](/cli/analytics): View analytics data from the terminal.
5248
- [Commands](/cli/commands): Complete reference for all commands and flags.

cli/preview.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ You must authenticate the CLI with your Mintlify account to enable search and th
3434
mint login
3535
```
3636

37-
After you authenticate with the `mint login` command, the CLI stores your credentials in `~/.config/mintlify/config.json` so you stay logged in across sessions. The CLI also prompts you to select a default project, which commands like `mint analytics` use.
37+
After you authenticate with the `mint login` command, the CLI stores your credentials in `~/.config/mintlify/config.json` so you stay logged in across sessions. The CLI also prompts you to select a default project, which commands like `mint workflow` use.
3838

3939
Once logged in, run `mint dev` to start the local preview with search and the assistant enabled. The assistant uses the same indexed content as your deployed documentation site.
4040

docs.json

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,6 @@
3838
"pages": [
3939
"cli/install",
4040
"cli/preview",
41-
"cli/analytics",
4241
"cli/commands"
4342
]
4443
},

es.json

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,6 @@
1616
"pages": [
1717
"es/cli/install",
1818
"es/cli/preview",
19-
"es/cli/analytics",
2019
"es/cli/commands"
2120
]
2221
},

es/changelog.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -470,7 +470,7 @@ noindex: true
470470
## Analíticas del CLI
471471
</div>
472472

473-
El comando [`mint analytics`](/es/cli/analytics) te permite ver el tráfico, las consultas de búsqueda, los comentarios de usuarios y las conversaciones del asistente desde la terminal para una mejor integración con agentes.
473+
El comando `mint analytics` te permite ver el tráfico, las consultas de búsqueda, los comentarios de usuarios y las conversaciones del asistente desde la terminal para una mejor integración con agentes.
474474

475475
Usa subcomandos para explorar datos específicos:
476476

0 commit comments

Comments
 (0)