Skip to content

πŸ“ˆ Open source, privacy-first web analytics β€” a cookie-less Google Analytics alternative with built-in error tracking and performance monitoring. Self-host it or use our cloud. Get started for free!

SEO mode docs

Blue Mouse67a4e5e5ad14
diff --git a/docs/content/docs/analytics-dashboard/meta.json b/docs/content/docs/analytics-dashboard/meta.json
index 32932ae23..6e613cbf2 100644
--- a/docs/content/docs/analytics-dashboard/meta.json
+++ b/docs/content/docs/analytics-dashboard/meta.json
@@ -3,6 +3,7 @@
"pages": [
"ask-ai",
"traffic",
+ "seo",
"performance",
"funnels",
"alerts",
diff --git a/docs/content/docs/analytics-dashboard/seo.mdx b/docs/content/docs/analytics-dashboard/seo.mdx
new file mode 100644
index 000000000..990b191a2
--- /dev/null
+++ b/docs/content/docs/analytics-dashboard/seo.mdx
@@ -0,0 +1,113 @@
+---
+title: SEO
+slug: /analytics-dashboard/seo
+---
+
+The SEO dashboard gives you a complete view of your website's search engine performance, powered by your [Google Search Console](/integrations/google-search-console) integration. It combines GSC data with your referral analytics to show search queries, top pages, branded traffic, and optimisation opportunities β€” all in one place.
+
+{/* TODO: Add screenshot of the SEO dashboard overview */}
+
+<Callout type="info">
+
+The SEO tab requires a connected Google Search Console account. If you haven't set this up yet, see [how to connect Google Search Console](/integrations/google-search-console).
+
+</Callout>
+
+## Performance Overview
+
+At the top of the SEO dashboard, four metric cards summarise your search performance for the selected period:
+
+- **Clicks** β€” Total clicks from Google Search results to your site.
+- **Impressions** β€” How many times your pages appeared in search results.
+- **Average CTR** β€” The percentage of impressions that resulted in a click.
+- **Average Position** β€” Your average ranking across all queries.
+
+Each metric shows a comparison badge against the previous period, so you can quickly spot trends.
+
+### Trend Chart
+
+Below the metrics, an area chart visualises your search performance over time. You can toggle which metrics are displayed using the visibility dropdown (eye icon):
+
+- Clicks and Impressions (shown by default)
+- Average Position
+- Average CTR
+
+When multiple metric types are shown together, the chart uses dual Y-axes for readability.
+
+## Search Engines & AI Referrals
+
+Two compact panels show your top traffic sources from search:
+
+- **Search Engines** β€” A breakdown of search engine referrals (Google, Bing, DuckDuckGo, etc.) based on your Swetrix analytics data.
+- **AI Referrals** β€” Traffic from AI-powered tools and assistants (ChatGPT, Perplexity, etc.) that link to your site.
+
+These panels show the top 10 sources with percentage bars and visitor counts.
+
+## Branded Traffic
+
+The branded traffic donut chart classifies your search queries into:
+
+- **Branded** β€” Queries that contain your brand name or configured brand keywords (e.g., searching for "swetrix analytics").
+- **Non-branded** β€” Generic queries where users found your site without searching for your brand (e.g., "privacy-friendly analytics").
+
+This helps you understand how much of your search traffic depends on brand awareness versus organic discovery.
+
+### Configuring Brand Keywords
+
+Swetrix automatically detects brand keywords from your project name and website URL. To customise them:
+
+1. Go to **Settings** > **General**.
+2. Find the **Brand keywords** field.
+3. Enter comma-separated keywords (e.g., `swetrix, swetrix analytics`).
+
+## Top Pages & Top Queries
+
+Two detailed panels let you drill into your search data:
+
+### Top Pages
+
+Shows which pages on your site receive the most clicks from search. Each page includes:
+
+| Column | Description |
+| --------------- | -------------------------------------------- |
+| **Page** | The URL path that appeared in search results |
+| **Clicks** | Number of clicks from search |
+| **Impressions** | Number of times the page appeared |
+| **CTR** | Click-through rate for the page |
+| **Position** | Average ranking position |
+
+### Top Queries
+
+Shows the search terms users type into Google to find your site. Each query includes the same metrics as Top Pages (clicks, impressions, CTR, position).
+
+Both panels support expanding to see the full list and can be sorted by any column.
+
+## SEO Quadrant
+
+The SEO Quadrant is a scatter plot that visualises all your search queries by **position** (X-axis) and **CTR** (Y-axis). Bubble size reflects the number of impressions.
+
+{/* TODO: Add screenshot of the SEO Quadrant chart */}
+
+The chart is divided into four areas by your average position and average CTR lines:
+
+| Quadrant | Meaning | Action |
+| ---------------- | -------------------- | --------------------------------------------------------- |
+| **Top-left** | High rank + high CTR | Your best performers β€” protect and maintain these |
+| **Bottom-left** | High rank + low CTR | Improve your title tags and meta descriptions |
+| **Top-right** | Low rank + high CTR | Boost these to page 1 for potentially big gains |
+| **Bottom-right** | Low rank + low CTR | Lowest priority β€” improve content or reconsider targeting |
+
+Hover over any bubble to see the exact query, position, CTR, and impression count.
+
+## Location & Devices
+
+Two additional panels break down your search performance by:
+
+- **Location** β€” Which countries your search clicks come from.
+- **Devices** β€” Performance split by Desktop, Mobile, and Tablet.
+
+Each includes the full set of GSC metrics (clicks, impressions, CTR, position).
+
+## Filters & Time Ranges
+
+The SEO dashboard shares the same time range selector and filter system as the rest of your project dashboard. Note that some short periods (like "Today" or "Last hour") are not available for SEO data, as Google Search Console data has a processing delay of 1–2 days.
diff --git a/docs/content/docs/analytics-dashboard/traffic.mdx b/docs/content/docs/analytics-dashboard/traffic.mdx
index 647098c44..7fd8e21b8 100644
--- a/docs/content/docs/analytics-dashboard/traffic.mdx
+++ b/docs/content/docs/analytics-dashboard/traffic.mdx
@@ -67,8 +67,10 @@ Identify how visitors find your website:
:::tip
Use our free **[UTM Generator](https://swetrix.com/tools/utm-generator)** to easily build trackable URLs for your campaigns.
:::
-- **Keywords**: If you have connected Google Search Console, this tab shows the search queries driving traffic to your site.
- - [Learn more about Google Search Console integration](/integrations/google-search-console).
+
+:::info
+Looking for search keywords, top pages, and other SEO data? Check out the dedicated **[SEO dashboard](/analytics-dashboard/seo)**, powered by your Google Search Console integration.
+:::
## Custom Events & Metadata
diff --git a/docs/content/docs/integrations/google-search-console.mdx b/docs/content/docs/integrations/google-search-console.mdx
index 35051d5fd..5ccf33ec6 100644
--- a/docs/content/docs/integrations/google-search-console.mdx
+++ b/docs/content/docs/integrations/google-search-console.mdx
@@ -4,15 +4,19 @@ title: Google Search Console
sidebar_label: Google Search Console
---
-Swetrix offers a seamless integration with Google Search Console (GSC), allowing you to view your search traffic data directly within your analytics dashboard. This integration bridges the gap between **Search Intent** (what users are looking for) and **On-site Behavior** (how they interact with your site).
+Swetrix offers a seamless integration with Google Search Console (GSC), powering the dedicated [SEO dashboard](/analytics-dashboard/seo) within your project. This integration bridges the gap between **Search Intent** (what users are looking for) and **On-site Behavior** (how they interact with your site).
## Why connect Google Search Console?
-By connecting GSC, you can unlock valuable SEO insights without leaving Swetrix:
+By connecting GSC, you unlock a full SEO analytics tab in your project dashboard:
-- **Keyword Analysis:** See exactly which search queries are driving traffic to your website.
-- **Performance Metrics:** Monitor Impressions, Clicks, Click-Through Rate (CTR), and Average Position for each keyword.
-- **Privacy-Focused:** View this data alongside your privacy-friendly analytics in a unified interface.
+- **Performance Overview:** Track Clicks, Impressions, Average CTR, and Average Position over time with period-over-period comparisons.
+- **Search Queries & Top Pages:** See which queries drive traffic and which pages rank best, with detailed metrics for each.
+- **Branded vs Non-branded Traffic:** Understand how much of your search traffic comes from brand-related queries.
+- **SEO Quadrant Analysis:** Visualize your queries by position vs CTR to identify optimisation opportunities.
+- **Search Engine & AI Referrals:** See which search engines and AI tools send visitors to your site.
+- **Geo & Device Breakdown:** Understand search performance by country and device type.
+- **Privacy-Focused:** View all of this alongside your privacy-friendly analytics in a unified interface.
## How to Set Up
@@ -43,17 +47,21 @@ You must have a Google Search Console account with your website property already
## Viewing Search Data
-Once connected, your search data will automatically populate in your project dashboard.
+Once connected, your search data will automatically populate in the dedicated **SEO** tab of your project dashboard.
-1. Go to your Project **Overview**.
-2. Scroll down to the **Traffic** panel (where Sources, Mediums, etc., are listed).
-3. Click on the **Keywords** tab.
+1. Open your project.
+2. Click the **SEO** tab in the project navigation.
-You will now see a list of keywords (queries) that users typed into Google to find your site, along with:
+You will see a full SEO dashboard with performance metrics, trend charts, search queries, top pages, and more.
-- **Clicks:** The number of times users clicked your link.
-- **Impressions:** How many times your site appeared in search results.
-- **CTR:** The percentage of impressions that resulted in a click.
-- **Position:** The average ranking of your site for that query.
+- [Learn more about the SEO dashboard](/analytics-dashboard/seo)
-This unified view helps you understand the complete marketing funnel: from the initial search intent on Google to the resulting engagement on your website.
+## Configuring Brand Keywords
+
+Swetrix automatically classifies your search queries as **branded** or **non-branded** traffic based on your project name and website URL. You can customise this by setting explicit brand keywords:
+
+1. Go to your project **Settings** > **General**.
+2. Find the **Brand keywords** field.
+3. Enter comma-separated keywords (e.g., `swetrix, swetrix analytics`).
+
+Queries containing any of these keywords will be classified as branded traffic in your SEO dashboard.
diff --git a/docs/content/docs/introduction.mdx b/docs/content/docs/introduction.mdx
index e781f4ca0..b29c88cd5 100644
--- a/docs/content/docs/introduction.mdx
+++ b/docs/content/docs/introduction.mdx
@@ -70,7 +70,7 @@ Swetrix works with any website or web application. We provide step-by-step integ
## Get the most out of Swetrix
- **[Email reports](/email-reports)** β€” Get regular traffic summaries delivered to your inbox
-- **[Google Search Console](/integrations/google-search-console)** β€” See search keywords alongside your analytics
+- **[SEO dashboard](/analytics-dashboard/seo)** β€” Track search performance with Google Search Console data
- **[Team collaboration](/teams-api-integrations)** β€” Invite team members and manage access permissions
- **[Custom alerts](/analytics-dashboard/alerts)** β€” Get notified about traffic spikes or unusual drops
- **[Public dashboards](/how-to-embed)** β€” Share your analytics publicly or embed them in your website