---
title: "Workspace, room and document analytics"
description: "Read the workspace dashboard, a single room’s numbers, and page-by-page results for one document."
canonical: "https://undocsend.com/docs/analytics/dashboards"
last_updated: "2026-11-19"
---

# Workspace, room and document analytics

Read the workspace dashboard, a single room’s numbers, and page-by-page results for one document.

## The workspace dashboard

Click **Analytics** in the sidebar. The **People** tab covers every room and share link in the workspace. At the top are four totals:

- **Total Visitors**: Everyone who has entered a room or share link, whether or not they opened a document.
- **Total Visits**: Every session, across all visitors.
- **Document Views**: Every time a document was opened.
- **Total Time**: Active reading time added up across all views.

Below them:

- **Visitor locations**: a map of where visits came from, with a count of visits and cities.
- **Views Over Time**: document views per day, for the 30 most recent days that had any views.
- **Top Documents**: the 10 most-viewed documents.
- **Campaign attribution**: see the next section.
- **Recent Activity**: the 10 latest document views, with who, what, when, time spent and pages read. Click a name to open the visitor, or a document to open its analytics.
- **Most Engaged Visitors**: the 5 visitors with the most reading time.

**View all visitors →** opens the full visitor list. See [Visitor profiles](https://undocsend.com/docs/analytics/visitors).

> Days are counted in your workspace’s time zone. Set it under **Settings → General** in the **Time zone** tile. Until you do, days run on UTC.

## Campaign attribution

This panel groups the last 30 days of visits by **Source**, **Medium** and **Campaign**, with a visit count and when each was **Last seen**. Visits with no source are left out.

To tag visits:

1. When you create a share link, pick an answer for **Where are you sharing this?**: Email, LinkedIn, X/Twitter, Newsletter, Warm intro, WhatsApp, or Other (then name the source).
2. Optionally add a **Campaign name**, for example “Seed round, October”.

Visits through that link then show the channel as the source. If the link the visitor clicked already carries its own `utm_source` tag, that tag wins. See [Sharing](https://undocsend.com/docs/sharing) for creating links.

## Room analytics

Open a room and click **Analytics** in the room menu. You get the same four totals, Views Over Time, Top Documents, Recent Activity and Most Engaged Visitors, limited to this room. Two things differ from the workspace dashboard:

- **Total Visitors** and **Total Visits** count only people and sessions that opened at least one document in the room.
- There is no location map or campaign panel. Use the workspace dashboard for those.

> **Share link views are counted separately**
>
> A view through a share link belongs to the link, not to a room, even when the file is also in a room. It shows on the workspace dashboard and on the file page, not in room analytics.

## Document analytics, page by page

To open one document’s analytics, do one of these:

- Click a document name in **Recent Activity** or in a visitor’s sessions.
- On the document’s page, click **Analytics by version** in the **Versions** card.

The page shows:

- **Total Views**: How many times the document was opened.
- **Unique Visitors**: How many different people opened it.
- **Avg. Time**: Average active time per view.
- **Page Analytics**: One row per page with its views and average time, so you can see where people slow down or stop.
- **Visitor Engagement**: One row per visitor with views, time, pages read and coverage. Click a row to see a heatmap of their time on each page. Darker squares mean more time; hover a square for the exact time.

### Versions

If you have replaced the file, a **Version** picker appears. Choose **All versions** or a single version, such as **v2**, to see only the views of that version. Page numbers can mean different things in different versions, so compare page results within one version.

## Views and downloads on the file page

Open **Files** in the sidebar and click a file. Its **Views** section shows the total views across every room and link, then one row per place the file is used (for example **Room: Series A** or **Link: Partner deck**) with views, time and the last view date.

The **Downloads** line counts visitor downloads split into PDF and original format. Downloads by your team are not counted.

## AI agents reading your rooms

A room can offer a plain, agent-friendly version of itself, called the machine view. Turn it on with **Enable machine view** in the room’s **Settings**. A visitor can then click **Connect your AI** in the room header to give their own AI tool a personal key, and the tool reads the room as text. The key only reaches what that visitor may see. To see these reads, open **Analytics** and click the **Agents** tab.

It lists the 200 most recent requests, newest first. For each one you see:

- The agent’s family, such as the AI company behind a crawler, **Headless** for automated browsers, or **Other**.
- The agent’s name, who it works for, and its purpose, when it says so.
- The document it read (click it to open the document’s analytics), or the path it requested.
- An approximate location, the time, and the full **User-Agent** text.

The totals at the top are **Recent hits**, **Distinct families** and **Self-identified**. Organisations that agents named appear under **Named on-behalf-of**.

> Name, organisation and purpose are self-reported by the agent. They are useful leads, not proof. To connect your own AI assistant to your workspace instead, see [AI agents](https://undocsend.com/docs/agents).

---

Section: Analytics and notifications. HTML: https://undocsend.com/docs/analytics/dashboards · Docs index: https://undocsend.com/docs.md
