---
title: "Appfire Comala Metadata app"
canonical: "https://support.appfire.com/space/CDML/649956848/Appfire%20Comala%20Metadata%20app"
format: markdown
---
> Macro (aura-html)


## Overview

This page details integration between the [Comala Metadata app‡](https://marketplace.atlassian.com/apps/5295/comala-metadata?hosting=datacenter&tab=overview) and Comala Document Management.

![image](media://12ac2113-b047-447a-a053-943259630fae)

The [Comala Metadata app](https://marketplace.atlassian.com/plugins/org.andya.confluence.plugins.metadata/server/overview) is the basis for the Comala Document Management metadata functionality, and as such, both apps are innately compatible with each other.

If you are using metadata values created with the Comala Document Management [set-metadata macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650251172), these are only indexed by Confluence and appear in the Confluence Search if the** **[Comala Metadata app](https://appfire.atlassian.net/wiki/spaces/COMALACM)** **is installed.

> ℹ️ ‡ You need to install** **[Comala Metadata](https://marketplace.atlassian.com/plugins/org.andya.confluence.plugins.metadata/server/overview)** **version 3.4 or above.

## Accessing metadata properties

Use [Value References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694302) to the metadata field you want to retrieve.

For example, to get the value of a metadata "Author" field, use

```plaintext
@Author@
```

If you want to retrieve metadata from another page, you can include the page title

```plaintext
@Page Title:Author@
```

You can retrieve values from pages in different spaces by including the [Space Key](https://confluence.atlassian.com/doc/space-keys-829076188.html)

```plaintext
@KEY:Page Title:Author@
```

For more information on using these, please view [Value References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694302) and/or [Metadata References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649925583).

## Accessing additional internal metadata

You can also reference [additional Confluence internal metadata](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/656578765).

## Accessing metadata supplier values

Values from the [Metadata Supplier](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/655889773) can be accessed via [Supplier References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649532510).

## Saving to metadata

Use the Comala Document Management [set-metadata](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650251172)**[ ](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650251172)**[macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650251172) to store metadata properties, which can then be read by the Comala Metadata app [metadata-from macro](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/656578971).

> ℹ️ The Comala Metadata app [metadata-from macro](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/656578971) can also read page-level workflow parameters when the Comala Document Management [workflowparameter macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650348884) is used with the `edit=true` parameter.

## See also

**Comala Metadata app**

- [Atlassian Marketplace - Comala Metadata app](https://marketplace.atlassian.com/plugins/org.andya.confluence.plugins.metadata/server/overview)
- [Comala Metadata documentation](https://appfire.atlassian.net/wiki/spaces/COMALACM)
- [metadata-from macro](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/656578971)

**Comala Document Management**

- [Metadata References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649925583)
- [Supplier References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649532510)
- [set-metadata macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650251172)
- [get-metadata macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649826804)