Latest Release
What's new and recently improved in Reports, Charts, Templates, CQL & Export for Confluence.
New Features and Improvements
CQL Query Support and Data Sources
Reports can now be built using flexible data source options, allowing both non-technical and advanced users to create dynamic Confluence reports.
| Feature | Description |
|---|---|
| Custom CQL Support | Build reports using Confluence Query Language to target content by space, type, labels, creator, title, created date, updated date, and other metadata. |
| Spaces Drill-down | Select spaces and pages visually without writing CQL. |
| Filters | Refine report results using filter rows with AND-based logic. |
| Include Children | Automatically include descendant pages under selected pages in Spaces mode. |
| Query Help Panel | Provides CQL syntax guidance and query support inside the editor. |
| New Filter Operators | Added >= and <= operators for numeric and date comparisons. |
Templates and Recipes
The Templates tab includes ready-to-use configurations for common reporting scenarios. Templates help users create reports quickly and consistently.
| Feature | Description |
|---|---|
| 35 Tabular Templates | Pre-built templates for governance, audits, activity tracking, stale content review, ownership tracking, attachments, labels, and content inventories. |
| 17 Chart Templates | Pre-built chart templates for dashboards, trends, content growth, contributors, comments, attachments, and activity analysis. |
| JSON Recipes | Export and reuse report configurations as JSON recipes. |
| Import Recipes | Paste a JSON recipe to recreate a complete report setup. |
| Copy JSON to Clipboard | Copy report configuration JSON from the Import tab. |
| Template Search | Search templates quickly from the Templates tab. |
| Lock/Edit Mode | Templates are locked by default to prevent accidental edits. Click Edit to unlock and customize. |
Save as a Macro and Live Reports
Reports are created and saved directly as Confluence macros.
| Feature | Description |
|---|---|
| Save as a Macro | Save the configured report directly on a Confluence page. |
| Live Auto-Updating Reports | Reports update automatically as Confluence content changes. |
| Permission-Aware Results | Viewers only see content they have permission to access. |
| Live Preview | Preview updates while configuring data source, expansions, columns, filters, templates, and views. |
Confluence API Expansions
The app supports Confluence API expansions to load additional metadata for reporting, filtering, charting, and debugging.
| Expansion Area | Examples |
|---|---|
| Structure | Ancestors, children, descendants, container. |
| Body and Metadata | Body, metadata, operations, restrictions, version. |
| History | Contributors, last updated, previous version, next version, owned by. |
Field Discovery and Debugging
New inspection tools make it easier to find correct fields and troubleshoot report configuration issues.
| Feature | Description |
|---|---|
| Raw JSON Debug View | Inspect the raw JSON data returned by Confluence and verify exact field paths. |
| Explore Fields Inspector | Browse available metadata fields, data types, and sample values. |
| Expansion Search | Search expansion fields in real time from the left panel. |
| Compatibility Count | See how many fields are compatible with each column block type. |
Pagination and Result Controls
The app includes controls for handling larger datasets and improving report readability.
| Feature | Description |
|---|---|
| Structured Pagination | Navigate large result sets with previous and next controls and page numbers. |
| Result Limit Controls | Set the maximum number of records returned, such as 50, 100, 500, or higher. |
| Large Dataset Handling | Use result limits, pagination, focused CQL, and minimal expansions to improve performance. |
Column Configuration
Column configuration has been expanded with flexible block types and easier column management.
| Feature | Description |
|---|---|
| Basic Column Type | Display plain text, numbers, IDs, dates, status, and simple metadata. |
| Collection Column Type | Display array or list data using custom joiners such as comma, pipe, or newline. |
| Image Column Type | Display images from URLs, including profile pictures and thumbnails. |
| Link Column Type | Create clickable links using separate link text and URL fields. |
| Regex Column Type | Extract or transform values using regex patterns. |
| Text Column Type | Format values with prefix, suffix, truncation, case transformation, and fallback values. |
| Drag and Drop Column Reordering | Reorder columns using drag-and-drop controls. |
| Duplicate Column | Copy an existing column configuration with one click. |
| Hide Column | Temporarily remove a column from display while preserving its setup. |
| Automatic Column Population | Applying templates automatically configures columns, filters, expansions, source, and view settings. |
Report Layouts
Reports can be displayed in multiple layouts depending on the audience and use case.
| Layout | Best For |
|---|---|
| Table | Audits, governance reports, structured data comparison, and CSV export. |
| List | Clean inventories, directories, and one-record-per-card views. |
| Paragraph | Weekly digests, executive summaries, newsletters, and change summaries. |
| Grid | Visual dashboards, team directories, profile cards, and page galleries. |
Charts
Charts provide visual analytics for Confluence content.
| Chart Type | Best For |
|---|---|
| Bar Chart | Comparing quantities across categories, such as pages per space, top editors, label usage, and active spaces. |
| Line Chart | Tracking change over time, such as page creation, page updates, comments, and blog publishing trends. |
| Pie Chart | Showing composition or distribution, such as content type mix, status distribution, and attachment file types. |
Export Options
Reports can be exported for offline analysis, sharing, debugging, or integration use cases.
| Export Type | Description |
|---|---|
| CSV Export | Export visible table data for Excel, Google Sheets, and stakeholder sharing. |
| JSON Export | Export report data as JSON for developers, integrations, backups, and debugging. |
| Configuration JSON Recipe | Copy the report setup as JSON to recreate the same report on another page. |
Marketplace
View the full app listing, reviews, and version history on the Atlassian Marketplace:
Reports, Charts, Templates, CQL & Export for Confluence on Atlassian Marketplace