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

## Parameters

| **Name** | **Required** | **Migratable to Cloud?** | **Default Value** | **Description** |
| --- | --- | --- | --- | --- |
| Field Name | Yes | No |  | The name of the text data field.<br>> ℹ️ The name must be unique. |
| Type | Optional | No | - **area **- if the macro is created with the Rich Text Editor.
- **line **- if the macro is created with wiki markup. | The type of field.<br>> ℹ️ Applies to plain text content only.<br>Can be:<br>- **area **- a multi-line text area field
- **line** - a single-line text area field
- **password **- a single-line password field<br>> ℹ️ Only applicable for forms mode. |
| Content Type | Optional | No | - **rich text** - if the macro is created with the Rich Text Editor.
- **wiki** - if the macro is created with wiki markup. | The type of content in the field.<br>Can be:<br>- **richtext**
- **text**
- **noformat**
- **quote**
- **code**
- **wiki**<br>> ℹ️ To input a field within a Text Data with **Content Type** set to **richtext **or **quote**, click the field to initiate a rich text editor. This is only applicable to forms mode. |
| Required | Optional | No | false | If `true` the field cannot be empty. |
| Language | Optional | No |  | The programming language to use for formatting the content is Java or XML.<br>> ℹ️ This is only used when the **Content Type** is set to **code**. For example, `content=code:JavaScript`.<br>Any language that is valid for the {code} macro can be used. |
| Hide Full Text | Optional | No | false | Clip text and display a *Show more* button if the text is more than one line. [v5.2.0 and later only]<br>![image](media://e3310f09-32a8-492e-844e-3fcea81e721c) |
| Minimum Length | Optional | No |  | If specified, the text must be at least this many characters long. |
| Maximum Length | Optional | No |  | If specified, the text must be at most this many characters long. |
| Pattern | Optional | No |  | Specify the text that the content in the Text Data macro must match.<br>You can use regular expressions with this parameter.<br>![image](media://ab203bfe-1bee-4468-b5ca-5e239a5a6800)<br>> ℹ️ Consult this [Knowledge Base article](https://appfire.atlassian.net/wiki/spaces/SCAFS/pages/477601169) on the use of regular expressions with Scaffolding. |
| Pattern Error Message | Optional | No |  | If the **Pattern **parameter is specified, this is displayed if the saved value does not match when the user clicks **Save**.<br>![image](media://aca1872d-bab1-40ba-8589-27ef9bbf8d5e) |
| Width | Optional | No |  | The width of the text field.<br>Can be in one of the following formats:<br>- pixels (e.g. `250px`)
- percentage (e.g. `100%`)<br>> ℹ️ Only applicable for forms mode. |
| Height | Optional | No |  | The height of the text field.<br>Can be in one of the following formats:<br>- pixels (e.g. `250px`)
- percentage (e.g. `100%`)<br>> ℹ️ Only applicable for forms mode. |

## Editor View

![image](media://56dca36f-6d66-4de0-8f5a-e85cb888dc7f)

## Notes

> ⚠️ Links to other pages inside a Text Data may break when the linked page is moved to another space. Clicking the broken link (pictured below) will prompt the user to create a new page.

![Page link](media://c8d908bd-7616-4c6d-ba59-7c5633a7afac)

## Tutorial Examples

> Macro (contentbylabel)