Reader analytics - Valueable insights on your documentation readers

Plans supporting this feature: Professional Business Enterprise

The Reader analytics page provides an overview of reader activity in your Private or Mixed access project. Use this tool to track user engagement and optimize your content strategy.

Accessing the Reader analytics page

To view reader analytics, from the Knowledge base portal,

Navigate to Analytics () in the left navigation bar in the Knowledge base portal.
In the left navigation pane, click Reader.

Using filters to customize data

By default, the data shows metrics for the last week. You can adjust this using filters:

Click the Date filter dropdown.
Select a predefined range (e.g., This month, Last month) or choose Custom to specify a date range.

If using the Knowledge base widget, use the top-right dropdown to switch between Knowledge base and Widget analytics.
Select the JWT widget to track and analyze user interactions and engagement of reader analytics within private and mixed projects secured by JWT authentication.
For more information on the Knowledge base widget JWT authentication, read the article on Managing the Knowledge base widget.
To filter readers by their registration type, use the dropdown menu to select All readers, Self-registration, SSO, JWT, and Invited readers.

NOTE
Reader analytics data can take up to 15 minutes to reflect in the Knowledge base portal.

Reader Analytics page overview

The Reader page shows the below three metric tiles, each representing absolute data points reflecting the overall reader analytics. These metrics remain unaffected by any filters applied to the data.

Field	Description
Total readers	Number of readers added to your project who can access the Knowledge base.
Self-registered readers	Readers who registered themselves on your Knowledge base site.
Frequent readers	Readers who frequently access your articles are calculated based on views and reads. If a reader is searched in the reader table using the search field, the reader gets updated in the frequently modified list.

Image showing reader analytics overview page

View reader analytics data

The Reader analytics section displays data for the for the selected duration, including the following fields:

Field	Description
Name	The profile picture and name of the Reader is available here. This is a clickable field. Click the reader’s name to view detailed information, including total views, reads, likes, dislikes, and a list of articles they've accessed, along with the average time spent and the last viewed date.
Email	Displays the email of the reader.
Reader type	Displays the type of reader based on their mode of registration like Self-registration, SSO, JWT, or Invited readers.
Views	The number of times an article is accessed is counted once per browser session. A view is recorded when an article loads in the browser, regardless of user interaction. Multiple visits to the same article within a session count as one view, even across tabs or windows or when a user closes and opens the same article within that particular browser session. Alternatively, if a user opens the same article in a different browser, device, clears the cache & reopens the article or refreshes the browser, they will count as another view. A browser session resets every 24 hours. Accessing the article after this period will count as another view.
Reads	An article read is recorded when a user engages through scrolling, clicking, or spending time on the page. The user has to perform all these three actions to count as one read. Scrolling: At least a single scroll is needed for a valid read. Time spent: Time is tracked only after 40 seconds spent on the article. If a user becomes idle (e.g., stops interacting) for some time or switches tabs, the timer pauses and resumes upon return. Session tracking: Time spent revisiting the same article within 24 hours in the same browser session is added to the previous session's total. Reads reflect meaningful interaction, distinguishing them from simple page loads.
Last login	Displays the login date of the reader’s most recent login. Click a reader's name to view their detailed login activity.

NOTE
Reader accounts do not have an inactivity timeout. The “last login” timestamp is updated only when a reader logs out and logs back in. Simply closing the browser tab or remaining logged in across sessions will not update the timestamp until a full logout and login cycle occurs.
Team accounts have a built-in 2-hour inactivity timeout. If a team member is inactive for 2 hours, they are automatically logged out. When they log in again even without a manual logout, the “last login” timestamp is updated. This ensures regular activity tracking, even across days.

Team accounts have a built-in 2-hour inactivity timeout. If a team member is inactive for 2 hours, they are automatically logged out. When they log in again even without a manual logout, the “last login” timestamp is updated. This ensures regular activity tracking, even across days.

Reader individual contributions

Click on a reader to view more detailed information about their contributions:

Profile: Team account name, Image, Email, Portal role, and Last login date and time (UTC time zone).
Contribution performance: Total views, Total reads, Total likes, and Total dislikes.
Articles: Displays a list of Article names to which the user has contributed, along with details such as Views, Reads, Likes, Dislikes, Created on, and Last updated date.
Export: To export and download the table as a CSV file to your local system.

Click the Filter button at the top to filter the analytics data based on

Article type (All, Page, Article)
Date (7 days, 30 days, Custom date)
Read receipt status (All, Yes, No) - only available for Private and Mixed projects

Once done, click Apply.
Hover over an article title and click View in Knowledge base () to open the article in the Knowledge base site.

Export reader analytics data

On the Reader page, click Export CSV to export and download the reader analytics in .csv format to your local storage.