--- title: "Workflow Report Macro - States" canonical: "https://support.appfire.com/space/CDML/650349253/Workflow%20Report%20Macro%20-%20States" format: markdown --- > Macro (aura-html) > Macro (excerpt-include) ## Overview > Macro (excerpt) > > Keep track of workflow states across multiple spaces. The **states** report macro displays lists of content and associated workflow state information. It's great for keeping track of content workflow states across multiple spaces. This is one of several reports available from the [workflow report macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649594703). > ℹ️ A new reporting macro with increased functionality - the [document states report macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649562443) - is now available. ## Permissions Anyone can see this report. [View-only users](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650217543) 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 which does not define a published state, will not be shown. Admins can make all results available to everyone by changing the **[Workflow Activity and Drafts Visibility](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649956239)** setting. ## Adding the report To add the report to a page: - choose **Workflow Report** in the macro editor ![image](media://0f880c21-f0b2-47b0-9b2f-8297da6a78e4) - Choose** Edit **the macro ![image](media://b0e50b83-7e4e-4adf-a8f3-1f6c5e9a56bb) - set the report **Type** to **states** ![image](media://a7dc2a2c-28d8-4106-b042-8b8fa9fa8716) - choose **Save** to add to the draft page ![image](media://89aea1eb-dfd8-4790-80fc-a6df1b6729fc) - choose **Publish ** to add the report to the page Here's how the report looks on your page. ![image](media://e9a11b03-8473-47a6-a119-21e138a1734d) You can **filter** the on-page report to specific states by using the links at the top of the report. ## Customizing the report You can customize the report with the following macro settings: | Setting | Default | Notes | | --- | --- | --- | | **Space Key(s)** | *Current space* | Which space(s) should be included in the report?
- Leave empty to report on the current space - Specify one [space key](https://confluence.atlassian.com/doc/space-keys-829076188.html) to report on a specific space - List multiple [space keys](https://confluence.atlassian.com/doc/space-keys-829076188.html), separated by commas, to report on multiple spaces - Specify `any` to report on all spaces. If you do this, you must specify only one state in the **State** setting. | | **State** | | Should the report be filtered to specific state(s)?
- Leave empty to report on all states - Specify one state name to report on that state - List multiple state names, separated by commas, to report on specific states | | **Max Entries** | 20 | The number of results to show per page.**†** | | **Label** | | Should the report be filtered by content label(s)?
- Leave empty to include all content - Specify 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 `&` (ampersand) to require that content has all the labels. | | **Parent Page Filter** | | Should the report be filtered to a specific parent page and the child pages of the specific page?
- Leave empty to include all content in the space - Specify a page title to include the specified page and its child pages | | **User** | | Should the report be filtered to content that the specified user can currently review?
- Leave empty to include all content - Specify a username to filter to results which that user can review - Specify `@self` to filter to results that the current user can review | | **Sort** | modified | Which column of the report should results be sorted by? | | **Sort Order** | descending | Should the sort be in ascending or descending order? | | **† **The macro has a 500-page limit for each report. If a larger report is required it may be useful to use the [CQL REST API](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649921636). | ## See also [Reporting Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649070833): - [Report on states](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650216427) [User Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648907144): - [Workflow Popup](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649659846) [Workflow Authoring Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648611901): - [States](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649595551) - [workflow-report macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649891099)