From ed99049f30867f484491439754da795ed99774df Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 1 Jul 2025 15:59:48 -0700
Subject: [PATCH 1/3] Create analytics.mdx

---
 guides/analytics.mdx | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 guides/analytics.mdx

diff --git a/guides/analytics.mdx b/guides/analytics.mdx
new file mode 100644
index 000000000..209a6d658
--- /dev/null
+++ b/guides/analytics.mdx
@@ -0,0 +1,5 @@
+---
+title: "Analytics"
+description: "See information about your docs' performance in your dashboard"
+icon: "chart-line"
+---
\ No newline at end of file

From 0f1b651926751d95fefe421d1de64ef07dff3e59 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 1 Jul 2025 16:00:55 -0700
Subject: [PATCH 2/3] add to `docs.json`

---
 docs.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs.json b/docs.json
index 1dd2fc50d..423bca30c 100644
--- a/docs.json
+++ b/docs.json
@@ -107,6 +107,7 @@
             "group": "Guides",
             "pages": [
               "guides/migration",
+              "guides/analytics",
               "guides/assistant",
               "mcp",
               "guides/cursor",

From bb1191cd35b11cc188b05751fb6cdbace720496c Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 1 Jul 2025 16:40:13 -0700
Subject: [PATCH 3/3] add page content

---
 guides/analytics.mdx | 46 +++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 45 insertions(+), 1 deletion(-)

diff --git a/guides/analytics.mdx b/guides/analytics.mdx
index 209a6d658..24af15258 100644
--- a/guides/analytics.mdx
+++ b/guides/analytics.mdx
@@ -2,4 +2,48 @@
 title: "Analytics"
 description: "See information about your docs' performance in your dashboard"
 icon: "chart-line"
----
\ No newline at end of file
+---
+
+The analytics page provides insights into how your documentation is performing, helping you identify improvement opportunities and track changes over time.
+
+## Accessing analytics
+
+Navigate to the **Analytics** tab in your [dashboard](https://dashboard.mintlify.com/products/analytics).
+
+Use the range selector to adjust the time period for displayed data.
+
+## Analytics tabs
+
+The analytics dashboard has three main sections:
+
+### Overview
+View traffic and other high-level insights about your docs.
+
+- **Visitors**: Unique visitors.
+- **Views**: Total page views.
+- **Actions**: Combined count of API calls, navbar link clicks, and CTA button clicks.
+- **Popular Pages**: Most-visited pages with view counts.
+- **Referrers**: Top traffic sources directing users to your docs.
+
+### Feedback
+Monitor user satisfaction through voting data:
+
+- **Liked by viewers**: Pages with the most positive feedback (thumbs up votes).
+- **Needs improvement**: Pages with the most negative feedback (thumbs down votes).
+
+### Search
+Understand how users search within your documentation.
+
+- **Total queries**: Search volume.
+- **Top searches**: Most-searched terms.
+- **Low-confidence searches**: Queries that may not have found relevant results.
+
+## Improving your docs with analytics
+
+Use your analytics to enhance the user experience of your docs:
+
+**Review popular content**: Ensure your most-visited pages contain current, accurate information and consider expanding successful topics.
+
+**Address feedback concerns**: Investigate pages with negative feedback to identify and resolve user pain points.
+
+**Optimize for search**: Review top search queries so that relevant pages are discoverable and up-to-date. Pay attention to low-confidence searches that might indicate content gaps.