---
title: "Metadata supplier for Appfire Reporting app"
canonical: "https://support.appfire.com/space/COMALACM/655889773/Metadata%20supplier%20for%20Appfire%20Reporting%20app"
format: markdown
---
> Macro (aura-html)

> 📝 The features described below require the [Appfire Reporting App](https://appfire.atlassian.net/wiki/spaces/REPS).

## Overview

> ℹ️ This sets up the Metadata supplier for Reporting v6.15.25 and above.

<span style="color: #000000">The </span><span style="color: #000000">**Workflow supplier**</span><span style="color: #000000"> provides metadata information attached to pages, blog posts, etc.,</span> to third-party apps, such as the [Reporting for Confluence app](https://marketplace.atlassian.com/plugins/net.customware.confluence.plugin.reporting/server/overview), using the [Confluence Suppliers for Reporting Library](https://appfire.atlassian.net/wiki/spaces/SUPSR).

<span style="color: #000000">This sets up the Metadata Supplier for Reporting Plugin versions 6.15.25 and above.</span>

## Compatibility

Appfire Reporting requires

- Reporting app **v6.15.25** in Confluence 7.13.11
- Reporting app **v6.18.7** in Confluence 8.1.0*

> 📝 *Use of Reporting app **v6.18.7** requires you to install Comala Metadata 4.2.12+.

## Details

| Name | Metadata Supplier |
| --- | --- |
| Prefix | `metadata` (required) |
| Supported content | Pages, Blog Posts, Spaces, Users |
| Provided By | [Confluence Metadata App 3.5+](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/656675586) |

# Keys Supported

| Key | Content Types | Return Type | Description |
| --- | --- | --- | --- |
| `no key` | Any | [List](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479035989) of [Entries](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479036179) | Returns the list of all Metadata |
| `Metadata name` | Any | [Text](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479035980) | Returns the metadata value associated with the current element. |
| `Any value from `columns available in [Reporting macros](https://appfire.atlassian.net/wiki/spaces/REPS/pages/472914693) | Any | Text | This works too, but most of those values return uninterpreted wiki syntax, requiring additional effort to utilize the returned values |

## Usage and Examples

The Appfire Reporting macros retrieve the metadata provided by the Comala Metadata app using the “**metadata:**” key.

For example

- If the following Comala Metadata **metadata list** macro is added to several pages for the three metadata references, `city`, `province`, and `country`.

![image](media://7218b50c-68eb-4e0f-9bb4-391c7c53deda)

 The Reporting app macros can be added to one of the pages to report on these metadata values.

![image](media://fa823947-cdd2-4279-a069-0dbdd13809f2)

Each **Report Column** macro utilizes the **metadata:** supplier to report on the metadata created in the metadata list macro.

For example, using `metadata:city`

![image](media://829f9e7c-a08d-4f29-bbad-a5da22739273)

The data is updated when the metadata on each page is modified.

### Replacement for metadata-report macro

The [Reporting app](https://appfire.atlassian.net/wiki/spaces/REPS) macros can be used to replace the [metadata-report macro](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/656579099). 

For example, the following `metadata-report`:

```plaintext
{metadata-report:Page,Metatest,Excerpt|link=Excerpt|label=meta}
```

Displays:

| Page | Metatest | Excerpt |
| --- | --- | --- |
| P1 (http://) | ABC | Excerpt for P1 |
| Home (http://) |  | Test Excerpt |
| P2 (http://) |  |  |

This can be replaced with:

```plaintext
{report-table}
{content-reporter:types=page|labels=+meta}{content-reporter}
{report-column:title=Page}{report-info:title|link=true}{report-column}
{report-column:title=Metatest}{report-info:metadata:Metatest}{report-column}
{report-column:title=Excerpt (column header)}{report-info:excerpt|link=true}{report-column}
{report-table}
```

Displays:

| Page | Metatest | Excerpt (column header) |
| --- | --- | --- |
| P1 (http://) | ABC | Excerpt for P1 (http://) |
| Home (http://) |  | Test Excerpt (http://) |
| P2 (http://) |  |  |

> ℹ️ The Reporting App syntax is more verbose, but more powerful.

Further examples are available in the [Appfire Reporting for Confluence app](https://marketplace.atlassian.com/plugins/net.customware.confluence.plugin.reporting/server/overview).

## Related pages

- [Reporting and Searching](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/656577723)
- [Retrieving and displaying page metadata](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/656677227)
- [Metadata reports for users, blog posts, and attachments](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/655890213)
- [Confluence Internal Metadata](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/656578765)