---
title: "Workflow Report Macro - Dashboard"
canonical: "https://support.appfire.com/space/CDML/649891836/Workflow%20Report%20Macro%20-%20Dashboard"
format: markdown
---
> Macro (aura-html)


> Macro (excerpt-include)



## Overview

> Macro (excerpt)
> 
> Keep track of your tasks across multiple spaces.

The **dashboard** report is used to display lists of document management tasks assigned to the user viewing the report. It's great for building custom dashboards.

This is one of several reports available from the [workflow report macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649594703).

## Permissions

Anyone can see this report, but they'll only see tasks assigned to them.

## Adding the report

To add the report to a page:

- choose **Workflow Report** in the macro browser
- set the **Type** setting to **dashboard**
- choose **Save**  
> Macro (inline-media-image)
- **Publish** the page

Here's how the macro looks on your page.

![image](media://509425fc-e6b2-498b-bec4-6dc7791d89e1)

The content for report will be seen for the current user, in this example <span style="color: #0000ff">Adam Samuel</span>.

## 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?<br>- Leave empty to report on the current space
- Specify one space key to report on a specific space
- List multiple space keys, 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. |
| **Max Entries** | 20 | The number of results to show per page. **† ** |
| **Label** |  | Should the report be filtered by content label(s)?<br>- 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<br>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?<br>- Leave empty to include all content in the space
- Specify a page title to include the specified page and its child pages |
| **Sort** | modified | Which column of the report should results be sorted by? |
| **Sort Order** | descending | Should the sort be in ascending or descending order? |
| **Hide Header** |  | Should the report title be removed? |
| **† **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 tasks](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649661358)

[Integration Guides](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649396230):

- [Reporting app - Tasks on current page](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649728225)