Dashboard Guide

1. Overview Dashboard

The Overview page is the first thing you see when you open a website's analytics. It gives you a high-level snapshot of your site's performance over the selected date range. Navigate to it via Analytics → Overview in the sidebar, or by clicking a website name from the Manage Sites list.

KPI cards

Six key performance indicator cards are displayed at the top of the page. Each card shows the current value for the selected period and a percentage change compared to the previous equivalent period.

Line chart

Below the KPI cards, a daily line chart plots visitors and page views over the selected date range.

Quick-glance cards

The bottom half of the Overview page shows summary cards:

2. Real-time / Live Activity

The real-time indicator sits at the top of the Overview page and shows how many visitors are currently active on your website. A visitor is considered "active" if they have sent a heartbeat or page view within the last 5 minutes.

How it works

The dashboard polls the GET /analytics/{website}/realtime endpoint every 30 seconds using jQuery AJAX. The endpoint returns a JSON object with the count of active sessions and a list of currently active pages.

{
  "active_sessions": 12,
  "pages": [
    { "path": "/pricing", "count": 4 },
    { "path": "/blog/getting-started", "count": 3 },
    { "path": "/", "count": 5 }
  ]
}

Live activity feed

The Live Activity page (Analytics → Live Activity in the sidebar) provides a streaming feed of sessions, page views, and events as they happen.

3. Sessions

The Sessions page (Analytics → Sessions) shows a chronological list of all browsing sessions on your website. Each row represents a single session with rich metadata.

Session list

Each session row displays:

• Visitor identifier — A truncated UUID linking to the visitor's detail page.
• Country & flag — Geo-resolved from the visitor's IP (the raw IP is never stored).
• Browser & OS — Parsed from the User-Agent header (e.g., Chrome 120 / macOS).
• Device type — Desktop, Mobile, or Tablet icon.
• Referrer domain — The site that sent the visitor, or "Direct" if none.
• UTM parameters — utm_source, utm_medium, and utm_campaign if present.
• Entry page — The first page viewed in the session.
• Duration — Total session time from start to last activity.
• Page views — Number of pages viewed in the session.
• Started at — Timestamp of the session's first hit.

Expandable page views

Click any session row to expand it and reveal the full list of page views within that session. Each page view shows:

• Page path and title
• Time spent on the page
• Scroll depth (0–100%)
• Timestamp

Page views are loaded via AJAX (GET /analytics/{website}/sessions/{session}/pageviews) so the initial page load stays fast even with thousands of sessions.

Pagination

Sessions are paginated with 25 per page by default. Use the pagination controls at the bottom to navigate through older sessions. The date filter at the top applies to the session list, so you can narrow down to a specific day or range.

4. Visitors

The Visitors page (Analytics → Visitors) shows a list of unique visitors who have been to your site during the selected date range.

Visitor list

Each visitor row summarises:

• Visitor UUID — A unique, anonymous identifier generated by the tracker and stored in the browser's localStorage. It cannot be reversed to a real identity.
• Total sessions — How many times this visitor has returned.
• Total page views — Cumulative pages viewed across all sessions.
• Country — The visitor's geo-resolved location.
• Device & browser — Hardware and software details.
• First seen / Last seen — When this visitor first appeared and their most recent activity.

Visitor detail page

Click any visitor to open their detail page (/analytics/{website}/visitors/{visitor}). This page provides:

• Visitor summary — Total sessions, total page views, total events, average session duration, first and last seen timestamps.
• Device information — Browser, operating system, device type, and screen resolution.
• Location — Country with flag icon.
• Session history — A complete timeline of every session this visitor has had, each expandable to show individual page views and events. This is invaluable for understanding how a specific user interacts with your site over time.

Visitor UUID tracking

Web Analyzer App identifies returning visitors using a UUID stored in localStorage rather than cookies. This approach is more privacy-friendly and is not affected by cookie consent banners. However, if a visitor clears their browser data or uses a different browser/device, they will appear as a new visitor.

5. Pages

The Pages report (Analytics → Pages) shows performance metrics for every page on your site, helping you identify your top content and underperforming pages.

Top pages table

The table lists every page URL that received at least one view during the selected period. Columns include:

Sorting

Click any sortable column header to sort the table by that metric. Click again to toggle between ascending and descending order. The current sort is indicated by an arrow icon next to the column name. Sorting is handled server-side via sort and dir query parameters.

6. Events

The Events page (Analytics → Events) tracks custom user interactions beyond page views — button clicks, form submissions, purchases, file downloads, and any action you choose to track.

Event summary cards & event log

At the top, summary cards show the total count for each event name. Below, a chronological log lists every event with details.

{ "order_id": "ORD-8842", "value": 49.99, "currency": "USD" }

Filtering by event name

Click any event summary card to filter the log to show only events of that type. This is useful when you have many event types and want to focus on a specific action. Click the card again (or click "All") to remove the filter.

7. Sources

The Sources page (Analytics → Sources) answers the critical question: where are your visitors coming from? It provides a tabbed interface with five views, each offering a different lens on your traffic origins.

Tabs

Channel classification

The Channel Overview tab uses Web Analyzer App's built-in referrer classifier to automatically categorise traffic into standard channels:

• Organic Search — Traffic from search engines (Google, Bing, DuckDuckGo, Yahoo, Baidu, etc.) without paid UTM parameters.
• Direct — Sessions with no referrer — typically visitors who typed your URL directly or used a bookmark.
• Referral — Traffic from other websites that do not fall into Search or Social categories.
• Paid — Sessions where utm_medium contains "cpc", "ppc", "paid", or "ad".
• Email — Sessions where utm_medium is "email" or the referrer is a known email provider.
• Social — Traffic from social media platforms (Facebook, Twitter/X, LinkedIn, Instagram, Reddit, YouTube, etc.).

8. Date Filtering

Every dashboard page respects the date filter, which controls the time range for all displayed data. The filter bar appears at the top of each analytics page.

How it works

How it works

When you change the date filter, the form submits a POST request to /analytics/{website}/filter. The selected range is stored in the server-side session under the key filter.{websiteId}, meaning:

• Per-website persistence — Each website remembers its own date filter independently. Switching between websites won't reset your date selection.
• Session-scoped — The filter persists for the duration of your login session. When you log out and back in, it resets to the default (Last 30 days).
• Cross-page consistency — The same date range applies to Overview, Sessions, Visitors, Pages, Events, and Sources. You set it once and all reports reflect the same period.

POST /analytics/{website}/filter
Content-Type: application/x-www-form-urlencoded

preset=custom&start=2026-02-01&end=2026-02-28

9. Data Export

Web Analyzer App lets you export your analytics data for use in spreadsheets, BI tools, or custom reporting pipelines.

How to export

On supported dashboard pages, click the Export button in the top-right area of the page. The export respects your currently selected date range and any active filters. Data is downloaded as a CSV file that you can open in Excel, Google Sheets, or any data tool.

Available exports

• Sessions — Session list with visitor ID, country, browser, device, referrer, UTM parameters, entry page, duration, page view count, and timestamps.
• Page Views — Individual page view records with path, title, time on page, scroll depth, and session reference.
• Events — Event log with name, payload (JSON), page path, visitor ID, and timestamp.
• Visitors — Visitor list with UUID, session count, page view count, country, device, and first/last seen dates.

API export

For programmatic access, use the Developer API to query analytics data. The API returns JSON and supports date range filtering, making it ideal for building custom dashboards or integrating with third-party tools.

10. Dark Mode

Web Analyzer App supports a full dark mode across every page — dashboard, marketing site, and documentation.

Toggle

Click the sun/moon icon in the top navigation bar to switch between light and dark themes. The toggle is available on every authenticated page and on the public marketing site.

Persistence

Your preference is saved in localStorage under the key darkMode. It persists across browser sessions and page reloads. The theme is applied by toggling the dark class on the <html> element, which Tailwind CSS uses for its dark: variant selectors.

Charts in dark mode

All Chart.js charts (line charts, donut charts) automatically adapt their colours, grid lines, and labels to match the active theme. No manual configuration is needed.

Metrics Glossary

A reference table defining every core metric used across the Web Analyzer App dashboard.