Confluence Page Word Count Badge

WHAT IT DOES

Confluence Page Word Count Badge scans any Confluence wiki page and displays a floating badge with key content metrics. It extracts text from the page body—excluding headers, navigation, comments, code blocks, and scripts—and counts the total number of words. Additional stats include character count (excluding spaces), estimated reading time based on your reading speed (WPM), and a breakdown by heading section showing the word count for each section. As you scroll through the page, a progress bar updates to show your reading progress. You can copy the entire word count summary as text for reporting or documentation. This helps you gauge the length of a page, estimate how long it will take to read, and understand the structure of the content.

WHERE IT RUNS

This script runs on Confluence wiki pages (*.atlassian.net/wiki/*). It operates entirely within your browser tab, reading the page's DOM to locate the main content area and extract text. The script cannot access other tabs, your browsing history, bookmarks, downloads, or any data outside the current page. All settings—including badge position, reading time visibility, character count visibility, section breakdown visibility, WPM, and auto-detect preference—are stored locally using GM_setValue and never transmitted anywhere.

HOW TO USE

After installing with the BotGentz extension, the script automatically detects Confluence pages and displays the word count badge (if auto-detect is enabled). The badge shows word count, character count, and reading time. Click "Count Words" to manually refresh the counts. The section breakdown shows how many words are in each heading section of the page. Customize the badge position (top-left, top-right, bottom-left, bottom-right, or float), toggle reading time, character count, and section breakdown on or off, and adjust your reading speed (WPM) to get accurate reading time estimates. Click "Copy Summary" to copy a formatted text summary to your clipboard.

THE REAL MECHANISM

The script detects Confluence page content using selectors like .wiki-content, .page-content, [data-testid="page-content"], and .article-content. It extracts the page title from .page-title or h1[data-testid="page-title"]. The content extraction uses a TreeWalker to traverse the DOM, excluding script, style, code blocks, and preformatted text to count only readable content. Sections are detected by finding heading elements (h1-h6) and splitting the content by these headings, creating a breakdown of word counts per section. The word count splits the text by whitespace and filters empty strings. Character count counts all non-whitespace characters. Reading time is calculated as word count divided by the user's WPM setting. The badge is rendered with stats and section breakdowns. All DOM manipulation uses safe methods with no innerHTML from untrusted content.

THE PANEL

The Word Count badge is displayed within the BGPanel component, which you can drag anywhere on your screen by its header. It snaps to the nearest edge when released, keeping your workspace organized. The panel collapses to a small bubble showing only the emoji icon when minimised—click to expand it again. You can resize the panel horizontally to see more of the section breakdown. Press the Escape key to collapse the panel instantly. Your panel position and size are saved per-site.

PLEASE NOTE

This script requires the free BotGentz browser extension to function. Confluence frequently updates its UI, which may change class names, data-testid attributes, and DOM structure—the script may require updates to maintain compatibility. The word count excludes code blocks and preformatted text to focus on readable content, but some formatting elements may still be included depending on the page structure. The section breakdown depends on heading elements being present; pages without headings will show a single section. The reading time is an estimate based on average reading speed—adjust the WPM setting to match your personal reading pace. The script never reads or writes password fields, hidden inputs, or file inputs. It stores only your badge position, reading time visibility, character count visibility, section breakdown visibility, WPM, and auto-detect preference locally. No page content, user data, or personal information is ever collected, transmitted, or shared.