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

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

<span style="color: #091e42">The </span>`metadata-from`<span style="color: #091e42"> macro is the simplest macro to get a piece of metadata from another page onto the current one.</span>

<span style="color: #091e42">The macro can only be used to retrieve the value of a single metadata value name.</span>

## Parameters

| Parameter | Required | Default | Notes | Version |
| --- | --- | --- | --- | --- |
| `value-name` | :check_mark: |  | The value name of the metadata to retrieve.<br>- Any wiki format that is part of the metadata value is rendered on the current page |  |
| `page` |  | `@self` | The page where the value name of the metadata has been added.<br>- The default value **@self** is the current page |  |

## Usage

> Macro (excerpt)
> 
> To retrieve a single metadata value from a page, choose the **Metadata from ** macro from the Confluence macro browser:
> 
> ![image](media://91f315fc-b81c-4faa-b64c-2bc9b7c5d6f4)
> 
> The macro editor lets you configure the macro.
> 
> ![metadata-from macro editor dialogue box options](media://517f7d73-51e8-480e-9fcd-97e12f7841e7)
> 
> The macro requires you to add both the:
> 
> - Metadata value name
> - Source page for the metadata name.
> 
> > ℹ️ If the metadata being retrieved is from the current page, you need to add `@self` to **Insert** the macro.
> 
> The macro retrieves the metadata value and displays it on the current page.
> 
> If the metadata includes any wiki formatting as part of the value, then this is rendered on the current page together with the value.
> 
> In the example, the value of the metadata **Division** has been defined using the Comala Metadata `metadata` macro.
> 
> ![image](media://87cf065c-11f7-4b6d-a1ec-6fe0d5d24e4c)
> 
> On the page, the metadata value is retrieved using the `metadata-from`** **macro.
> 
> ![image](media://5bc26657-463f-45f4-8e3f-ff5898d9a8bd)
> 
> In this example, the display would simply be the value of the metadata **Division** filtered to be from the page **Project initiation Document**.
> 
> ![image](media://bce2c86b-44b7-4b84-975c-bfe747b76ed0)

## Markup Reference

```plaintext
{metadata-from:Project Initiation Document|Division}
```

  
In this example, the **Project Initiation Document** page contains the metadata name **Division, **whose value has been set to **Digital Products**.

The `metadata-from`** **macro retrieves the value for **Division** from the page **Project Initiation Document**.

The following retrieves the value of **Division** metadata from the current page (if present):

```plaintext
{metadata-from:Division}
```

## Usage with the Comala Document Management app

The `metadata-from` macro is** supported** by the Comala Document Management app and works at the workflow level.

## 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)