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

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

  1. Open your Confluence space and go to Space settings → Page View Analytics

  2. Set a date range, or use a quick-select preset: 1m, 3m, or 6m

  3. Enter a Top N pages value (e.g. 20) — this is required before loading

  4. Open Show filters if you want to narrow results by label, title, or parent page

  5. Click Load Analytics — the table and chart build progressively

  6. 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.