---
title: "Augments - Cloud"
canonical: "https://support.appfire.com/space/TBL/74815166/Augments%20-%20Cloud"
format: markdown
---
> Macro (aura-html)

# <span style="color: #000000">Overview</span>

<span style="color: #000000">Augments are a set of macro parameters that provide the ability to augment the data found in the table with additional columns derived from other available information. More capabilities are planned for the future. </span><span style="color: #000000">Augments are supported in the</span> [CSV (Comma Separated Values) macro](https://appfire.atlassian.net/wiki/spaces/TBL/pages/74812384) <span style="color: #000000">and the</span> [JSON Table macro](https://appfire.atlassian.net/wiki/spaces/TBL/pages/74818011)<span style="color: #000000">.</span>

<span style="color: #000000">Sometimes, users have little control over how data is produced, for example, when importing CSV files generated by external processes. This affects t</span><span style="color: #000000">he way data is displayed in Confluence as the format may not be optimal.</span> <span style="color: #000000">However, use of both augments and replacement keys can improve the look of such data in Confluence. The use of replacement keys that can be used with augments are</span><span style="color: #000000"> </span><span style="color: #000000">explained in a </span><span style="color: #000000">[subsequent section](https://appfire.atlassian.net/wiki/spaces/TBL/pages/74815166/Augments+-+Cloud#replacement)</span><span style="color: #000000">.</span>

# <span style="color: #000000">Parameters</span>

| <span style="color: #000000">**Macro Browser Label**</span> | <span style="color: #000000">**Description**</span> | <span style="color: #000000">**Parameter**</span> |
| --- | --- | --- |
| <span style="color: #000000">Augments</span><span style="color: #000000"> to d</span><span style="color: #000000">ata row values</span> | <span style="color: #000000">Enter a comma-separated list of augments to the data row values, one for each column. Specify double quotes for values with a comma.</span> | <span style="color: #000000">augments</span> |
| <span style="color: #000000">Augments to heading row values</span> | <span style="color: #000000">Enter a comma-separated list of augments to heading row values, one for each column.</span> | <span style="color: #000000">headingAugments</span> |
| <span style="color: #000000">Augments to footing row values</span> | <span style="color: #000000">Enter a comma-separated list of augments to footing row values, one for each column.</span> | <span style="color: #000000">footingAugments</span> |
| <span style="color: #000000">Columns to show</span> | <span style="color: #000000">Enter </span><span style="color: #000000">a comma-separated list of </span><span style="color: #000000">comma separated list of column names or numbers in any order. By default, all columns are displayed in its existing order. Note that columns are indexed beginning at "1" and exclude any auto-numbered columns. For augment support, use </span><span style="color: #000000">*****</span><span style="color: #000000"> to represent an augmented column to be added.</span> | <span style="color: #000000">columns</span> |

## > Macro (anchor)

<span style="color: #000000">Replacement keys</span>

<span style="color: #000000">Replacement keys enclosed in </span><span style="color: #000000">**%**</span><span style="color: #000000"> can have replacements as indicated in the table. For example, a </span><span style="color: #000000">**%#%**</span><span style="color: #000000"> key is replaced with the current row number. </span>

> ⚠️ <span style="color: #000000">Confluence Cloud does not support macros inside a macro (nested macros). So, a replacement key such as </span><span style="color: #000000">**%json-table%**</span><span style="color: #000000"> is not supported.</span>

| <span style="color: #000000">**Key**</span> | <span style="color: #000000">**Replacement**</span> | <span style="color: #000000">**Difference if heading or footing row?**</span> |
| --- | --- | --- |
| <span style="color: #000000">*</span> | <span style="color: #000000">original value</span> |  |
| <span style="color: #000000">empty</span> | <span style="color: #000000">original value</span> |  |
| <span style="color: #000000">blank</span> | <span style="color: #000000">blank</span> |  |
| <span style="color: #000000">#</span> | <span style="color: #000000">row number (starting at 1 for the first data row)</span> | <span style="color: #000000">blank</span> |
| <span style="color: #000000">number</span> | <span style="color: #000000">value of the column identified by column number (1-based count)</span> |  |
| <span style="color: #000000">name</span> | <span style="color: #000000">value of the column identified by column name lookup, if valid</span> |  |
| <span style="color: #000000">!</span> | <span style="color: #000000">| (can be needed when using wiki markup)</span> |  |
| <span style="color: #000000">[</span> | <span style="color: #000000">{ (can be needed when using wiki markup)</span> |  |
| <span style="color: #000000">]</span> | <span style="color: #000000">} (can be needed when using wiki markup)</span> |  |

# <span style="color: #000000">Examples</span>

<span style="color: #000000">This section lists examples of using augments with the </span><span style="color: #000000">[CSV (Comma Separated Values)](https://appfire.atlassian.net/wiki/spaces/TBL/pages/74812384)</span><span style="color: #000000"> and </span><span style="color: #000000">[JSON Table](https://appfire.atlassian.net/wiki/spaces/TBL/pages/74812316)</span><span style="color: #000000"> macros. In addition to the augment examples, also look at the</span><span style="color: #091e42"> </span><span style="color: #000000">[Confluence CLI output examples](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68457585)</span><span style="color: #091e42"> </span><span style="color: #000000">and</span><span style="color: #091e42"> </span><span style="color: #000000">[Jira CLI output examples](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70788245)</span><span style="color: #091e42"> </span><span style="color: #000000">that use augments.</span>

> Macro (children)

# <span style="color: #000000">Additional references</span>

- [Example output with augments](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70788245) - [Jira CLI ](https://appfire.atlassian.net/wiki/spaces/JCLI)<span style="color: #000000">output examples</span>
- [Example output with augments](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68457585) - [Confluence CLI](https://appfire.atlassian.net/wiki/spaces/CSOAP) <span style="color: #000000">output examples</span>