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
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.
- 1TrafficHow many sessions, bot sessions and users
Data Export API metric: Traffic
- 2Popular pagesWhich pages get the most page views
Data Export API metric: Popular Pages
- 3Scroll depthHow far visitors get down a page
Data Export API metric: Scroll Depth
- 4Engagement timeHow long visitors spend on a page
Data Export API metric: Engagement Time
- 5Rage clicksWhere visitors click repeatedly in one spot
Data Export API metric: Rage Click Count
- 6Dead clicksWhere a click got no response
Data Export API metric: Dead Click Count
- 7Excessive scrollingWhere visitors scroll faster than normal reading
Data Export API metric: Excessive Scroll
- 8Quick backsWhere visitors leave a page and return at once
Data Export API metric: Quickback Click
- 9Script and click errorsWhich JavaScript errors visitors hit
Data Export API metric: Script Error Count, Error Click Count
| # | Card | What it answers | Data Export API metric |
|---|---|---|---|
| 1 | Traffic | How many sessions, bot sessions and users | Traffic |
| 2 | Popular pages | Which pages get the most page views | Popular Pages |
| 3 | Scroll depth | How far visitors get down a page | Scroll Depth |
| 4 | Engagement time | How long visitors spend on a page | Engagement Time |
| 5 | Rage clicks | Where visitors click repeatedly in one spot | Rage Click Count |
| 6 | Dead clicks | Where a click got no response | Dead Click Count |
| 7 | Excessive scrolling | Where visitors scroll faster than normal reading | Excessive Scroll |
| 8 | Quick backs | Where visitors leave a page and return at once | Quickback Click |
| 9 | Script and click errors | Which JavaScript errors visitors hit | 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.
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
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
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
| Option | Where it lives | Cost | Limits worth knowing |
|---|---|---|---|
| Clarity dashboard | clarity.microsoft.com, project, Dashboard | Free | Filters and segments slice it; cards can be rearranged and hidden; it shows data in your local time zone |
| Your own script or BI tool | Any client that can send a GET request with a Bearer token | Your tool's cost | The Data Export API allows 10 requests per project per day and returns the last 1 to 3 days, up to 1,000 rows |
| Ryze AI | The Ryze AI chat, Claude or ChatGPT | Paid Ads plan, $89 a month, 7-day free trial | 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.
Sessions
- API name
- Traffic: totalSessionCount
- Plain definition
- Visits to the site; a session ends after 30 minutes of inactivity
Bot sessions
- API name
- Traffic: totalBotSessionCount
- Plain definition
- Sessions Clarity detected as bots
Distinct users
- API name
- Traffic: distantUserCount
- Plain definition
- Count of distinct users in the period
Pages per session
- API name
- Traffic: PagesPerSessionPercentage
- Plain definition
- Average pages viewed in a session
Popular pages
- API name
- Popular Pages
- Plain definition
- Pages ranked by number of page views
Scroll depth
- API name
- Scroll Depth
- Plain definition
- How far down the page visitors scrolled
Engagement time
- API name
- Engagement Time
- Plain definition
- Time visitors spent on the site
Rage clicks
- API name
- Rage Click Count
- Plain definition
- A visitor repeatedly clicked in a clustered area within a brief period
Dead clicks
- API name
- Dead Click Count
- Plain definition
- A visitor clicked and there was no response
Excessive scrolling
- API name
- Excessive Scroll
- Plain definition
- A visitor scrolled faster than expected for standard reading
Quick backs
- API name
- Quickback Click
- Plain definition
- A visitor went to a new page and quickly returned to the previous one
Script errors
- API name
- Script Error Count
- Plain definition
- JavaScript errors detected while the page ran
Error clicks
- API name
- Error Click Count
- Plain definition
- JavaScript errors detected after a visitor click
| Metric | API name | Plain definition |
|---|---|---|
| Sessions | Traffic: totalSessionCount | Visits to the site; a session ends after 30 minutes of inactivity |
| Bot sessions | Traffic: totalBotSessionCount | Sessions Clarity detected as bots |
| Distinct users | Traffic: distantUserCount | Count of distinct users in the period |
| Pages per session | Traffic: PagesPerSessionPercentage | Average pages viewed in a session |
| Popular pages | Popular Pages | Pages ranked by number of page views |
| Scroll depth | Scroll Depth | How far down the page visitors scrolled |
| Engagement time | Engagement Time | Time visitors spent on the site |
| Rage clicks | Rage Click Count | A visitor repeatedly clicked in a clustered area within a brief period |
| Dead clicks | Dead Click Count | A visitor clicked and there was no response |
| Excessive scrolling | Excessive Scroll | A visitor scrolled faster than expected for standard reading |
| Quick backs | Quickback Click | A visitor went to a new page and quickly returned to the previous one |
| Script errors | Script Error Count | JavaScript errors detected while the page ran |
| Error clicks | Error Click Count | 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.
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.
Daily, 2 minutes
- What to check
- Traffic, then rage clicks and dead clicks by URL
- Why
- Friction on one page often follows a release
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
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
After a release
- What to check
- Script errors and error clicks by browser
- Why
- Error clicks are errors that follow a visitor click
Monthly
- What to check
- Saved segments and card order
- Why
- Segments that no longer match your site waste a look
| When | What to check | Why |
|---|---|---|
| Daily, 2 minutes | Traffic, then rage clicks and dead clicks by URL | Friction on one page often follows a release |
| Every 3 days | Copy the figures you want to keep into your own sheet | The export covers only the last 1 to 3 days, so older numbers are gone from it |
| After a campaign change | Scroll depth and quick backs for the campaign's landing URL | Quick backs mark visitors who left at once |
| After a release | Script errors and error clicks by browser | Error clicks are errors that follow a visitor click |
| Monthly | Saved segments and card order | 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.
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.
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
Time window
- Clarity dashboard
- Date ranges set in the filters
- Ryze AI
- The last 1 to 3 days
Recordings and heatmaps
- Clarity dashboard
- In the same project
- Ryze AI
- Not available through the tool
Writes to Clarity
- Clarity dashboard
- You change settings and segments
- Ryze AI
- None: the tool is read-only
Projects
- Clarity dashboard
- All projects on your Clarity account
- Ryze AI
- One project per connection; the token decides which
Request limits
- Clarity dashboard
- Not applicable inside the app
- Ryze AI
- Clarity allows 10 export requests per project per day
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
| Question | Clarity dashboard | Ryze AI |
|---|---|---|
| Cost | Free | Paid Ads plan $89 a month, 7-day free trial; the tool works on any active plan or trial |
| Time window | Date ranges set in the filters | The last 1 to 3 days |
| Recordings and heatmaps | In the same project | Not available through the tool |
| Writes to Clarity | You change settings and segments | None: the tool is read-only |
| Projects | All projects on your Clarity account | One project per connection; the token decides which |
| Request limits | Not applicable inside the app | Clarity allows 10 export requests per project per day |
| Best for | Looking at a card, then opening the sessions behind it | 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.
401 Unauthorized
- Likely cause
- Missing, invalid or expired token
- Fix
- Generate a new token under Settings, Data Export and reconnect
403 Forbidden
- Likely cause
- Token not authorized for the operation
- Fix
- Check that the token comes from the right project
400 BadRequest
- Likely cause
- Invalid request parameters
- Fix
- Use numOfDays 1, 2 or 3 and at most 3 dimensions
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
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
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
| Problem | Likely cause | Fix |
|---|---|---|
| 401 Unauthorized | Missing, invalid or expired token | Generate a new token under Settings, Data Export and reconnect |
| 403 Forbidden | Token not authorized for the operation | Check that the token comes from the right project |
| 400 BadRequest | Invalid request parameters | Use numOfDays 1, 2 or 3 and at most 3 dimensions |
| 429 Exceeded daily limit | More than 10 requests for the project in a day | Wait for the next day and ask for several metrics per message |
| Numbers differ from the dashboard | The API is in UTC and the dashboard uses your local time zone | Compare the same hours in the same zone |
| Ryze AI cannot see Clarity | The connector was added before Clarity was connected | 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
Checked November 19, 2026
- Microsoft Learn: Clarity Data Export API
- Microsoft Learn: Clarity dashboard features
- Microsoft Learn: Clarity filters overview
- Microsoft Learn: Clarity glossary of terms
- Microsoft Learn: Clarity FAQ
- Microsoft Learn: Clarity MCP server
- Ryze AI help center: Microsoft Clarity
- Ryze AI help center: Plans and pricing
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.





