---
title: "Attachment upload"
canonical: "https://support.appfire.com/space/SCAFC/477470275/Attachment%20upload"
format: markdown
---
> Macro (aura-html)
The Attachment upload field in the Field Group macro creates an input field for attaching a file. This input field is useful for workflows that require users to attach files, such as scanned documents, receipts, photos, DOC files, or PDF files.
## Macro editor view
To insert an Attachment upload field into the Field Group macro editor, either drag it from the sidebar or use the `/attachment upload` command.
## Field settings
To open the Number text field settings, select the field in the Field Group macro editor and click **Edit **(:edit-pencil:).
| **Parameter** | **Type** | **Default value** | **Description** |
| --- | --- | --- | --- |
| **Field name** | Required | A random name is generated by default. | A unique name for the field. Used when integrating Scaffolding with other apps such as [Reporting for Confluence](https://appfire.atlassian.net/wiki/spaces/RFC). |
| **Helper text** | Optional | N/A | Context or additional information about the field input. Displayed below the field only in content edit mode. |
| **Include** | Optional | N/A | A Java regex to define the allowed file names for attachment.
For example, enter `.*pdf` to allow only PDF file attachments.
> ℹ️ In Java regular expressions, the pattern `.*` means zero or more of any character. |
| **Exclude** | Optional | N/A | A Java regex to define the file names that are not allowed for attachment.
For example, enter `.*exe` to restrict EXE file attachments.
> ℹ️ In Java regular expressions, the pattern `.*` means zero or more of any character. |
| **Required** | Boolean | False | If enabled, the field is mandatory.
> ℹ️ In the content editor, attempting to save the form with a mandatory field left empty results in an error. |
## Content editor view
When editing content in the Field Group macro, the Attachment upload field lets you specify an attachment to upload or select a previously uploaded attachment.
