App Documentation
Page View Analytics is a Confluence Forge app for space administrators. It provides ranked page view counts, time-series trend charts, and one-click report publishing — all without leaving Confluence and without sending any data outside your tenant.
Documentation
Section | What you'll find |
|---|---|
Getting Started | Who can use the app, prerequisites, how to open it, and a step-by-step walkthrough of your first analysis |
Filters | All filter types — Top N, label, title keyword, and parent page — with guidance on when to use each |
Results: Analytics Table & Trend Chart | How to read the results table, sort and search it, and how the trend chart is built |
Publishing a Report | How Publish Report works, what gets included, re-publishing behaviour, and sharing |
Permissions, Privacy & GDPR | Who can access the app, required Confluence permissions, OAuth scopes, and data handling |
Rate Limits & Troubleshooting | How the app handles API rate limits, what the diagnostics panel shows, and solutions to common problems |
Quick start
Open your Confluence space and go to Space settings → Page View Analytics
Set a date range, or use a quick-select preset: 1m, 3m, or 6m
Enter a Top N pages value (e.g. 20) — this is required before loading
Open Show filters if you want to narrow results by label, title, or parent page
Click Load Analytics — the table and chart build progressively
Click Publish Report to save the results as a Confluence page
Key concepts
Top N pages
The only required field. It caps how many pages appear in the results table and trend chart. Keeping this small (10–50) is the simplest way to keep load times fast and avoid hitting Confluence API rate limits on large spaces.
Filters
Four optional filters you can apply before loading to narrow the analysis: label (server-side — fetches only tagged pages), title keyword (client-side match), and parent page (subtree scoping with depth control: ancestor only, direct children, or all descendants).
Trend chart
A time-series line chart showing total page views for the top N pages across your selected date range. Granularity is automatic: daily for ranges up to 60 days, weekly up to 180 days, monthly for longer ranges.
Published report
A formatted Confluence page with the trend chart and the full rankings table with hyperlinks. Re-publishing overwrites the previous version in place — no duplicate pages are created.
All processing runs inside your Atlassian tenant via Atlassian Forge. No page data, analytics data, or user data is sent to any external server.