Ira Bodnar··Updated ·11 min read

Microsoft Clarity dashboard: metrics, cards and AI prompts

Quick answer: The Microsoft Clarity dashboard is the project overview in Clarity with cards for traffic, scroll depth, engagement time, popular pages and friction signals such as rage clicks and dead clicks. Ryze AI is the best AI option for asking about recent Clarity numbers from Claude, ChatGPT or its own chat, with one caveat: its single read-only tool covers only the last 1 to 3 days and no recordings or heatmaps.

This guide is for marketers and site owners who check Clarity on a schedule: the metrics and the names the Data Export API uses, a 9-card template, how to customize the native dashboard, prompts for Ryze AI and a weekly routine.

Ryze AI · Paid Ads

Ask Ryze AI about your Clarity data

  • 7-day free trial, $89 a month flat

Used by 2,000+ marketers

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

Microsoft Clarity dashboard template at a glance

9 cards cover reach, attention and friction. Each one maps to a metric the Clarity Data Export API returns, so a person, a script or an AI tool can read the same numbers.

  1. 1TrafficHow many sessions, bot sessions and users

    Data Export API metric: Traffic

  2. 2Popular pagesWhich pages get the most page views

    Data Export API metric: Popular Pages

  3. 3Scroll depthHow far visitors get down a page

    Data Export API metric: Scroll Depth

  4. 4Engagement timeHow long visitors spend on a page

    Data Export API metric: Engagement Time

  5. 5Rage clicksWhere visitors click repeatedly in one spot

    Data Export API metric: Rage Click Count

  6. 6Dead clicksWhere a click got no response

    Data Export API metric: Dead Click Count

  7. 7Excessive scrollingWhere visitors scroll faster than normal reading

    Data Export API metric: Excessive Scroll

  8. 8Quick backsWhere visitors leave a page and return at once

    Data Export API metric: Quickback Click

  9. 9Script and click errorsWhich JavaScript errors visitors hit

    Data Export API metric: Script Error Count, Error Click Count

The right column shows the metric name the export uses for the same measure.

3 ways to read a Microsoft Clarity dashboard in 2026

The choice is where you look at the numbers: in Clarity, in your own script, or in an AI chat that asks Clarity for you.

Clarity is free: Microsoft says it is a free service with no traffic limits and no paid tier (Clarity FAQ). The project dashboard is the default view, and the same figures can be pulled through the Data Export API.

  1. Clarity dashboard

    Where it lives
    clarity.microsoft.com, project, Dashboard
    Cost
    Free
    Limits worth knowing
    Filters and segments slice it; cards can be rearranged and hidden; it shows data in your local time zone
  2. Your own script or BI tool

    Where it lives
    Any client that can send a GET request with a Bearer token
    Cost
    Your tool's cost
    Limits worth knowing
    The Data Export API allows 10 requests per project per day and returns the last 1 to 3 days, up to 1,000 rows
  3. Ryze AI

    Where it lives
    The Ryze AI chat, Claude or ChatGPT
    Cost
    Paid Ads plan, $89 a month, 7-day free trial
    Limits worth knowing
    One read-only tool for one Clarity project; no cards are drawn and no recordings or heatmaps are returned

Microsoft also publishes its own Clarity MCP server, which signs in with OAuth and reaches session recordings and AI Visibility reports as well. It is compared with the Ryze AI connector on the Microsoft Clarity MCP page.

Microsoft Clarity metrics and API names for the dashboard

The Data Export API returns the metrics below, per the Microsoft Learn reference. Name them in a prompt and an AI tool knows which measure you mean.

  1. Sessions

    API name
    Traffic: totalSessionCount
    Plain definition
    Visits to the site; a session ends after 30 minutes of inactivity
  2. Bot sessions

    API name
    Traffic: totalBotSessionCount
    Plain definition
    Sessions Clarity detected as bots
  3. Distinct users

    API name
    Traffic: distantUserCount
    Plain definition
    Count of distinct users in the period
  4. Pages per session

    API name
    Traffic: PagesPerSessionPercentage
    Plain definition
    Average pages viewed in a session
  5. Popular pages

    API name
    Popular Pages
    Plain definition
    Pages ranked by number of page views
  6. Scroll depth

    API name
    Scroll Depth
    Plain definition
    How far down the page visitors scrolled
  7. Engagement time

    API name
    Engagement Time
    Plain definition
    Time visitors spent on the site
  8. Rage clicks

    API name
    Rage Click Count
    Plain definition
    A visitor repeatedly clicked in a clustered area within a brief period
  9. Dead clicks

    API name
    Dead Click Count
    Plain definition
    A visitor clicked and there was no response
  10. Excessive scrolling

    API name
    Excessive Scroll
    Plain definition
    A visitor scrolled faster than expected for standard reading
  11. Quick backs

    API name
    Quickback Click
    Plain definition
    A visitor went to a new page and quickly returned to the previous one
  12. Script errors

    API name
    Script Error Count
    Plain definition
    JavaScript errors detected while the page ran
  13. Error clicks

    API name
    Error Click Count
    Plain definition
    JavaScript errors detected after a visitor click

Definitions of rage clicks, dead clicks, excessive scrolling and quick backs come from the Clarity filters page; the session definition is in the Clarity glossary. The export also lists browser, device, OS, country or region, page title and referrer URL among its metrics.

  • Breakdowns: dimension1, dimension2 and dimension3 each take one of Browser, Device, Country/Region, OS, Source, Medium, Campaign, Channel or URL. A request accepts at most 3.
  • Period: numOfDays is 1, 2 or 3 and counts back from the API call as the last 24, 48 or 72 hours.
  • Time zone: the API returns results in UTC, while the Clarity dashboard shows your local machine time zone, so day boundaries can differ.
  • Size: a response holds up to 1,000 rows and cannot be paged.

How to set up the template in Clarity

Clarity gives every project a dashboard once the tracking code is installed, so setup means arranging cards and saving the filters you reuse.

Open the Clarity dashboard

Open your project in Clarity and go to Dashboard. The Clarity dashboard is the default view and needs no extra setup.

Order the cards

Select the hamburger menu icon at the left of a card and drag it. Put traffic and popular pages first, then the friction cards.

Hide what you do not use

Open a card's Menu and choose Hide card. Hidden cards sit at the bottom of the dashboard and come back with Unhide card. They are left out when you download the dashboard.

Set default tabs

For cards with several tabs, choose Menu, then Select default tab.

Save the filters you reuse

Combine filters such as Device, Channel or Entry URL and save them as a segment, so the same slice opens each week.

Track a segment

Use Add to watchlist on the Watchlist card to follow the share of sessions that match a segment, custom tag or label. The watchlist is yours alone and is not shared with your team.

Other dashboards (Advertising, Google Analytics, Agent Performance) appear only when the project is connected to those services, per Microsoft's dashboard features page. Clarity FAQ: data is retained for the webmaster for up to 30 days from the time of recording.

Ryze AI prompts for Microsoft Clarity data

Ryze AI does not draw a Clarity dashboard. Its Clarity tool, clarity__read, fetches behavior insights for the connected project over the last 1 to 3 days, so you ask for the cards in a chat.

Generate a token

In Clarity, open the project, then Settings, Data Export, Generate new API token, and copy it. Each token belongs to one project.

Connect Clarity

In the Ryze AI app, open Integrations, click Connect on the Microsoft Clarity card, paste the token, optionally add a project name, and click Continue.

Or connect from chat

Ask the Ryze AI agent in Claude or ChatGPT to connect Microsoft Clarity. It sends a one-time link, valid once and for 24 hours, to a page where you paste the token.

Ask a question

Use the prompts below in the Ryze AI chat, or in Claude or ChatGPT with the connector at https://connector.get-ryze.ai/mcp.

Prompt 1: reach and attention
Use Microsoft Clarity. For the last 3 days, show traffic and engagement time broken down by device. Give sessions, bot sessions and pages per session in one table, and name the date range you used.
Prompt 2: friction signals
For the last 2 days, list rage clicks, dead clicks and quick backs broken down by URL. Put the 5 URLs with the highest counts first and say which signal each one is flagged for.
Prompt 3: paid traffic landing pages
Fetch scroll depth for the last 3 days broken down by campaign and URL. Which campaign and landing page pairs have the lowest scroll depth? Keep the list to 10 rows.
Prompt 4: errors
Show script errors and error clicks for the last day broken down by browser. Point out any browser where the counts stand out against the others.

The tool reads traffic, scroll depth, engagement time, popular pages, referrers, dead clicks, rage clicks, excessive scrolling, quick backs and script and error clicks, split by up to 3 dimensions. It does not return session recordings or heatmaps and cannot change anything in Clarity. Setup details are in the Ryze AI Clarity guide.

A weekly routine for the Clarity dashboard

The API holds only 3 days and allows 10 requests a day, so the routine saves what matters instead of relying on history.

  1. Daily, 2 minutes

    What to check
    Traffic, then rage clicks and dead clicks by URL
    Why
    Friction on one page often follows a release
  2. Every 3 days

    What to check
    Copy the figures you want to keep into your own sheet
    Why
    The export covers only the last 1 to 3 days, so older numbers are gone from it
  3. After a campaign change

    What to check
    Scroll depth and quick backs for the campaign's landing URL
    Why
    Quick backs mark visitors who left at once
  4. After a release

    What to check
    Script errors and error clicks by browser
    Why
    Error clicks are errors that follow a visitor click
  5. Monthly

    What to check
    Saved segments and card order
    Why
    Segments that no longer match your site waste a look

A fixed prompt makes the check repeatable. Because of the 10-request daily limit, ask for several metrics in one message instead of one request per metric.

Check prompt
Using Microsoft Clarity for the last 3 days, give me traffic, scroll depth and engagement time by device, then rage clicks, dead clicks and quick backs by URL. Name the 3 URLs that look worst and the signal behind each. Note that results are in UTC.

Clarity dashboard vs Ryze AI prompts

Clarity shows cards and links them to recordings and heatmaps. Ryze AI answers a question about recent numbers in a chat.

  1. Cost

    Clarity dashboard
    Free
    Ryze AI
    Paid Ads plan $89 a month, 7-day free trial; the tool works on any active plan or trial
  2. Time window

    Clarity dashboard
    Date ranges set in the filters
    Ryze AI
    The last 1 to 3 days
  3. Recordings and heatmaps

    Clarity dashboard
    In the same project
    Ryze AI
    Not available through the tool
  4. Writes to Clarity

    Clarity dashboard
    You change settings and segments
    Ryze AI
    None: the tool is read-only
  5. Projects

    Clarity dashboard
    All projects on your Clarity account
    Ryze AI
    One project per connection; the token decides which
  6. Request limits

    Clarity dashboard
    Not applicable inside the app
    Ryze AI
    Clarity allows 10 export requests per project per day
  7. Best for

    Clarity dashboard
    Looking at a card, then opening the sessions behind it
    Ryze AI
    Quick questions about the last few days by prompt

Use the Clarity dashboard when you need to watch a recording, and Ryze AI when you want a quick table of recent behavior data without opening Clarity. For other analytics dashboards, see PostHog dashboard and Google Analytics dashboard.

Common Microsoft Clarity dashboard problems and fixes

Most errors come from the token or the daily request limit.

  1. 401 Unauthorized

    Likely cause
    Missing, invalid or expired token
    Fix
    Generate a new token under Settings, Data Export and reconnect
  2. 403 Forbidden

    Likely cause
    Token not authorized for the operation
    Fix
    Check that the token comes from the right project
  3. 400 BadRequest

    Likely cause
    Invalid request parameters
    Fix
    Use numOfDays 1, 2 or 3 and at most 3 dimensions
  4. 429 Exceeded daily limit

    Likely cause
    More than 10 requests for the project in a day
    Fix
    Wait for the next day and ask for several metrics per message
  5. Numbers differ from the dashboard

    Likely cause
    The API is in UTC and the dashboard uses your local time zone
    Fix
    Compare the same hours in the same zone
  6. Ryze AI cannot see Clarity

    Likely cause
    The connector was added before Clarity was connected
    Fix
    Remove and re-add the connector, then start a new chat

The error codes and the 10-request, 1,000-row and 3-dimension limits are from the Data Export API reference. Clarity advises replacing a token promptly when a person with access leaves the project.

Where Ryze AI fits

Ryze AI reads Clarity for the agent in the Ryze AI chat, Claude and ChatGPT. The tool is read-only, so nothing in Clarity changes.

No Ryze AI plan feature or in-app dashboard is tied to Clarity. Approvals are set per tool in Claude under Customize, Connectors, Ryze AI, Tool permissions, and the Ryze AI chat starts with its Tool approvals picker on Skip all approvals. More on the connector is on the Microsoft Clarity MCP page.

The Paid Ads plan is $89 a month with a 7-day free trial. The Clarity tool also works on SEO Starter ($129 a month, 3-day free trial) and Agency ($279 a month). Connecting is free, and the tools need an active plan or trial. Annual billing is 30% off the first year. All integrations are listed on the integrations hub.

Sources

The verdict

A useful Clarity dashboard is short: traffic, popular pages, scroll depth, engagement time and the four friction signals. Keep it in Clarity, where each card leads to recordings and heatmaps.

If you want a quick answer by prompt, Ryze AI reads the last 1 to 3 days of the same project through one read-only tool, in a chat, in Claude or in ChatGPT.

Frequently asked questions

What is the Microsoft Clarity dashboard?
The overview of a Clarity project, with aggregate cards for traffic, scroll depth, engagement time, popular pages and friction signals such as rage clicks and dead clicks. Filters and segments slice it, and cards can be rearranged or hidden.
Is Microsoft Clarity free?
Yes. Microsoft's FAQ says Clarity is a free service with no traffic limits and no paid tier. Ryze AI is a separate product: its Paid Ads plan is $89 a month with a 7-day free trial.
What metrics does the Clarity dashboard show?
Traffic, popular pages, scroll depth, engagement time, rage clicks, dead clicks, excessive scrolling, quick backs and JavaScript errors. The Data Export API returns the same measures under the names Traffic, Popular Pages, Scroll Depth, Engagement Time, Rage Click Count, Dead Click Count, Excessive Scroll, Quickback Click, Script Error Count and Error Click Count.
What is a rage click in Clarity?
A rage click is a visitor repeatedly clicking in a clustered area within a brief period. Clarity's filters page says it helps identify frustration points in a design. A dead click is a click with no response.
Show 7 more questions
What are the Clarity Data Export API limits?
Microsoft documents 10 API requests per project per day, data for the previous 1 to 3 days, up to 3 dimensions per request and 1,000 rows per response with no paging. A 429 with the message Exceeded daily limit means the daily limit was reached.
Can Ryze AI build a Clarity dashboard?
No. Ryze AI has no Clarity dashboard. Its Clarity tool fetches behavior insights for one project over the last 1 to 3 days, so you ask for tables and summaries in a chat.
Can Ryze AI show Clarity recordings or heatmaps?
No. The Ryze AI Clarity tool does not return session recordings or heatmaps. Those stay in Clarity. Microsoft's own Clarity MCP server does cover session recordings.
How do I connect Clarity to Ryze AI?
In Clarity, open the project, go to Settings, Data Export and generate a new API token. In the Ryze AI app, open Integrations, click Connect on the Microsoft Clarity card, paste the token, and click Continue.
Can I see Clarity trends over weeks with Ryze AI?
Not from Clarity alone. The Data Export API serves only the last 1 to 3 days, so the tool cannot return weeks or months of history. Save the figures you need to compare.
Can I connect more than one Clarity project?
Each Ryze AI workspace holds one Clarity project, and the token decides which. To switch, disconnect in View and connect again, or use another workspace.
Does Microsoft have its own Clarity MCP server?
Yes. Microsoft publishes the Clarity MCP server, which uses OAuth sign-in and is run with npx or installed through a client. It is compared with the Ryze AI connector on the Microsoft Clarity MCP page.

Related guides

Ryze AI: Clarity data by prompt

7-day free trial, $89 a month

Start free trial