The Usage tab in the HTML Macro admin settings gives site administrators a complete view of every Confluence page that contains an HTML Macro. Use it to audit adoption, spot stale pages, or quickly navigate to any macro for review.
Note: This tab is only visible to Confluence site administrators.
At the top of the Usage tab, three summary cards give you an instant snapshot:
| Stat | What it shows |
|---|---|
| Total Pages | Number of Confluence pages that contain at least one HTML Macro |
| Published Pages | Pages in a published (non-draft) state |
| Spaces | Number of distinct Confluence spaces using the macro |
Below the stats, a full-page table lists every page using the macro. The table supports:
| Column | Description |
|---|---|
| Page Title | The title of the Confluence page |
| Excerpt | A short snippet of the page content |
| Space | The Confluence space the page belongs to |
| Status | Current page status (e.g. current, draft) |
| Last Modified | Date the page was last edited |
| Link | Button to open the page directly in Confluence |
Click any column header to sort the table by that column. Click again to reverse the sort order.
Use the search box above the table to filter rows across all columns at once. The filter is applied instantly as you type — no need to press Enter.
The table loads 20 pages per request. Use the pagination controls at the bottom to navigate:
The current page and total count are shown between the navigation buttons.
Click the external link icon (↗) in the Link column to open the page directly in Confluence. The page opens in Confluence's built-in viewer without leaving the admin settings panel.
