---
title: "Page Properties Report macro"
canonical: "https://support.appfire.com/space/CDML/650250574/Page%20Properties%20Report%20macro"
format: markdown
---
> Macro (aura-html)


## Overview

> Macro (excerpt)
> 
> Filter page property reports based on Workflow search filters

The [Page Properties Report macro](https://confluence.atlassian.com/doc/page-properties-report-macro-186089616.html), bundled with Confluence, allows you to compile reports of metadata stored by the [Page Properties macro](https://confluence.atlassian.com/doc/page-properties-macro-184550024.html) on pages and blog posts which have workflows applied.

> ℹ️ This feature requires **Confluence 5.8 or above**.

## Setting up the report

Add the **Page Properties Report** macro to a wiki page in the usual way and [configure it to your requirements](https://confluence.atlassian.com/doc/page-properties-report-macro-186089616.html).

In the sidebar you'll see an option to specify a label, and, under it, an option to **Add a filter**:

![image](media://8b952ac6-d456-44ec-bc9c-fb80f55d82bd)

Search the **Add filter** drop-down for filters containing the word **Workflow** – these are the filters added by the Comala Document Mangement app.

In the example above, we've selected the **Workflow State** filter. That filter automatically provides a list of all states available on your wiki, so all you need to do is choose one.

## Available filters

> Macro (include)

> ℹ️ The current workflow state can also be retrieved as a metadata value using @awpState@.

An example of some of the filters in action:

![image](media://6e9bde95-124d-4d9a-9b95-4eb3c27a96b5)

See also

## External Links

- [Page Properties Report macro](https://confluence.atlassian.com/display/CONF51/Page+Properties+Report+Macrohttps://confluence.atlassian.com/doc/page-properties-report-macro-186089616.html)
- [Page Properties macro](https://confluence.atlassian.com/doc/page-properties-macro-184550024.html)
- [Advanced Searching Using CQL](https://developer.atlassian.com/server/confluence/advanced-searching-using-cql/)
- [CQL Field Reference](https://developer.atlassian.com/server/confluence/cql-field-reference/)
- [CQL Function Reference](https://developer.atlassian.com/server/confluence/cql-function-reference/)
- [CQL Keywords Reference](https://developer.atlassian.com/server/confluence/cql-keywords-reference/)
- [CQL Operators Reference](https://developer.atlassian.com/server/confluence/cql-operators-reference/)
- [Performing Text Searches with CQL](https://developer.atlassian.com/server/confluence/performing-text-searches-using-cql/)

[Reporting Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649070833)

- [Confluence Search](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649792098)
- [Content by Label macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649956370)

[Workflow Authoring Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648611901)

- [Approvals](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650153766)
- [States](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649595551)
- [Tasks](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694408)
- [Value References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694302) – [Page Property References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649728272)

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

- [CQL REST API](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649921636)