Document Stats Report Macro

Overview

The Document Stats Report is used to display a count of the content currently in each workflow state.

This workflow information in the reporting columns, by default, includes all the workflow states in the current space (except for the space homepage).

One or more filters can be added to the document-stats-report macro, for example, to filter the display to specific states or the states in one or more workflows.

Once added to a page, the report macro will dynamically update the count of the states.

Permissions

Anyone can see this report.

view-only users will only see results for content that has reached a Published ( final=true ) state, even if there are subsequent draft state edits to that content
content that has not yet been published or content under a workflow that does not define a published state, is not be shown

Adding the report

To add the report to a page, choose the Document Stats Report macro.

On a draft page, either

choose Insert → Other Macros → Reporting → Document Stats Report
or type {doc stats ... on the page
select Document Stats Report (or open the macro browser to search)

select the macro
choose Edit

choose report filters and display column settings

if necessary, scroll down the macro editor to add or edit report filter options

By default, the report displays a count for all workflow states, including those where no content is currently in the state

choose Save to update the macro on the draft page
choose Update to add the report to the page

Here's how the report looks on your page.

Customizing the report

Edit the Document Stats report macro to customize the report by

You can choose to filter the state count for the content by

label(s)
parent
space(s) using the space key

If multiple labels are added, the report displays the state information for content with each label. If you want to display information for content that must have all the specified labels, add the & (and ampersand) operator in front of the first label in the list

The macro can also be customized for

one or more states
one or workflows

The order of the column displayed on the page is defined by the order of entry of the state name column in the macro editor.

Filter the report

In the macro editor, select options to filter the report. These include options to filter by state, workflow, space key, label, and parent page(see table below).

If a workflow has been removed from content that is in the scope of the report macro but the history has been retained, the report will show the last state information for the content.

The filters are listed alphabetically in the macro editor.

Setting	Default	Notes

Setting	Default	Notes
Label	blank	Should the report be filtered by content label(s)? leave empty to include all content list one label name to filter to a specific label list multiple label names, separated by commas, to filter to content with any of those labels If using a list of labels, you can prefix the list with the & (ampersand) to require that the content has all the labels. Otherwise, it reports on pages containing any of the listed labels.
Parent page	blank	Report limited to child pages of the specified page. leave empty to include all content in the current space (does not include the home page as this is the default parent) specify a page title to include only its child pages use @self to specify child pages of the current page
Ancestor page	blank	The report is limited to the descendant pages of the specified page. use @self to report on the descendant pages of the current page specify a page title to include only its descendant pages If specifying an ancestor page, you cannot list multiple space keys. The report defaults to the descendant pages of the added page.	v2.4.0+ DATA CENTER
Spaces	blank	Which space should be included in the report? accepts one or more space keys leave empty to include all content in the current space (does not include the current space home page as this is the default parent) If a parent page is added, you cannot specify more than one space.
State(s)	blank	The count for all the states in the scope of the macro editor settings is displayed. leave empty to include all content in all states limit report by listing one or more state names in a comma-separated list The report includes the state count for content where the workflow has been removed, but the workflow history has been retained
Workflow	blank	A comma-separated list of workflows to be displayed. leave empty to include all content in all states in all workflows limit report by listing one or more workflow titles in a comma-separated list If left empty, then the report includes the state count for content where the workflow has been removed but the workflow history has been retained

Use with Confluence chart macro

The document stats report macro can be added to the Confluence chart macro to display the report information.

The Confluence chart macro display is based on the document-stats-report macro filters.

Related pages

Document States Report macro