---
title: "metadata-values macro"
canonical: "https://support.appfire.com/space/COMALACM/655759047/metadata-values%20macro"
format: markdown
---
> Macro (aura-html)

## <span style="color: #091e42">Overview</span>

<span style="color: #091e42">The </span>`metadata-values`<span style="color: #091e42"> m</span><span style="color: #333333">acro lists all of the metadata attached to a specified page</span><span style="color: #091e42">.</span>

<span style="color: #091e42">The macro only displays the </span><span style="color: #091e42">**metadata defined on the page**</span><span style="color: #091e42">. It does not display any metadata values retrieved from other pages.</span>

## Parameters

| Parameter | Required | Default | Notes | Version |
| --- | --- | --- | --- | --- |
| `page` (or unnamed *first* *parameter)* | :check_mark: | `@self` | The individual content page to retrieve any added metadata and values from.<br>- The default is to the current page |  |
| `orientation` |  | `vertical` | The tabular report is displayed either<br>- `orientation=vertical`
- `orientation=horizontal` |  |

## Usage

> Macro (excerpt)
> 
> To list all the single metadata and metadata values on a page:
> 
> - Choose the **Metadata values **macro from the Confluence macro browser
> 
> ![image](media://d7b350f9-b233-4c8a-ad4f-92445f3a1169)
> 
> The macro editor lets you configure the macro.
> 
> ![image](media://4390b7c2-3b5c-4670-be28-5da91581ef5c)
> 
> The macro displays any metadata and its value on the specified page in tabular format. If no page is specified, the default page is the current page, defined by `@self`.
> 
> Any metadata on the page is displayed in the macro editor **Preview, **with the option to display the metadata in a vertical or horizontal table.
> 
> If there is no metadata added on the specified page, the **Preview** displays the following warning:
> 
> ![image](media://604667b4-c5cf-4033-ac35-0114789ceefb)
> 
> A message is also displayed on the published page.
> 
> > 📝 The macro does not list any space metadata added to the page. Only metadata added using the [metadata](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/655988203) macro and the [metadata-list](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/655758458) macro is displayed.

## Markup reference

```plaintext
{metadata-values|orientation=horizontal}
```

This displays any metadata names and the values on the current page:

![image](media://4ba9a8a1-a9e5-4563-882e-0718e6e696b1)

## Usage with the Comala Document Management app

The `metadata-values` macro is partially supported by the Comala Document Management app at the workflow level.

```plaintext
{metadata-values}
```

Use of the macro with the `orientation` parameter is unsupported at the workflow level in the Comala Document Management app. For example, using`{metadata-values|orientation=horizontal}` displays an error.

## Related macros

> Macro (children)

## Related documentation

- [Adding metadata to a page](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/656676899)
- [Retrieving and displaying page metadata](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/656677227)