---
title: "Table Data"
canonical: "https://support.appfire.com/space/SCAFS/477600119/Table%20Data"
format: markdown
---
> Macro (aura-html)

## Parameters

| Name | Required | Migratable to Cloud? | Default Value | Description |
| --- | --- | --- | --- | --- |
| [default]/name | Yes | No |  | The name of the table.<br>> ℹ️ The name must be unique*.* |
| initialRows | Optional | No |  | The number of rows to have in the section initially<br>> ✅ Saves a user from having to click the **Plus **(** + **) button repeatedly. |
| order | Optional | No | ascending | Sort order for content.<br>If set to **descending:**<br>- The content will be sorted in reverse order.
- New rows will be added to the top of the repeating section. |
| width | Optional | No |  | The width of the field<br>- percentage (e.g. `80%`)
- pixels (e.g. `500px`)<br>> ℹ️ Only applicable for forms mode. |

## Notes

Due to the simplistic parser currently being used, you must be careful with how you format the table.

- The main requirement is that any `|` characters that mark a table boundary must have whitespace on either side.
- Conversely, any character other than `|` must **not** have any whitespace around it.

For example, in the markup below, there are the following errors:

- The *Number *column has no whitespace around the `|` markers.
- The *Date *column **does** have whitespace inside the macro.

```
{table-data: My Table}
|| Text||\Number ||Date||
| {text-data:Text}|{number-data:Number}0{number-data}|{date-data:Date| format=dd-MMM-yyyy} |
{table-data}
```

- <span style="color: #172b4d">The correct formatting option is:</span>

```
{table-data:My Table}
|| Text || Number || Date ||
| {text-data:Text} | {number-data:Number}0{number-data} | {date-data:Date|format=dd-MMM-yyyy} |
{table-data}
```

## Related pages

> Macro (contentbylabel)