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

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

<span style="color: #091e42">The </span>`space- metadata-from`<span style="color: #091e42"> macro </span><span style="color: #333333">can retrieve one piece of metadata from a space.</span>

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

## Parameters

| Parameter | Required | Default | Notes | Version |
| --- | --- | --- | --- | --- |
| `value-name` | ![image](media://1be765f2-5611-4f72-9eb6-9ac5d1e3167c) |  | The value name of the space metadata to retrieve.<br>Any wiki format that is part of the metadata value is rendered on the current page. |  |
| `space` |  |  | The space where the value name of the space metadata has been added.<br>- Defaults to the current space |  |

## Usage

> Macro (excerpt)
> 
> To retrieve a single metadata value from a space
> 
> - Choose the **space metadata from **macro from the Confluence macro browser
> 
> ![image](media://79a13834-5f04-48ee-a01e-42f7f74644f5)
> 
> The macro editor lets you configure the macro.
> 
> ![image](media://7e08388e-25ee-4ed9-9be9-302b034fd2d7)
> 
> The macro requires you to add the space metadata value name.
> 
> The source space defaults to the current space. To retrieve space metadata from another space, add the space key for the space.
> 
> In the example, the metadata `Team Owners` has been defined using the `space-metadata`** **macro. Once you choose Insert, the macro placeholder is displayed on the edit for the current page, with the metadata value name appended.
> 
> ![image](media://bf44a06a-46b5-45e1-9a0c-fd39b6fbddab)
> 
> The value of `Team Owners` is displayed on the current page. In our example, the space metadata value was added as `Comala Development Superstars`**.**
> 
> ![image](media://06d21c7e-fd30-405c-861a-4db3f85fe672)
> 
> If the metadata included any wiki formatting as part of the value, then this is rendered on the current page together with the value. Otherwise, the value is displayed unformatted.
> 
> ![image](media://346f7852-f7ce-42b9-a31e-b31371a913eb)

## Reference Markup

```plaintext
{space-metadata-from:Department|space=HR}
```

## Usage with the Comala Document Management app

The `space- metadata-from` macro is **NOT supported** by the Comala Document Management app and will not work at the workflow level. No value is displayed.

## Related macros

> Macro (contentbylabel)

## Related pages

- [Adding metadata to spaces](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/655988362)
- [Retrieving and displaying space metadata](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/655758622)
- [Using metadata in a space](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/655758361)