---
title: "Files list"
canonical: "https://support.appfire.com/space/SCAFC/477463921/Files%20list"
format: markdown
---
> Macro (aura-html)

The Files list field in the Field Group macro creates a dropdown list for selecting a file from the attachments of a predefined page and inserting a link to it.

For example, you can create an input field for selecting:

- A screenshot of an error message from a troubleshooting article
- An image of a product requirement form
- An invoice associated with an order form

## Macro editor view

To insert a Files list field into the Field Group macro editor, either drag it from the sidebar or use the `/files list` command.

![files_list_macro_editor.png](media://55bb6c3a-a236-4865-a5ea-7a1f025c5f2d)

## Field settings

To open the Files list 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. |
| **Page** | Optional | The current page | A Confluence page to populate the dropdown list with its attachments. |
| **Required** | Boolean | False | If enabled, the field is mandatory.<br>> ℹ️ 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 Files list field lets you select a file from the attachments of a predefined page and insert a link to it.

![files_list_content_editor.png](media://364db6e0-ab58-4984-9219-4d60c414c194)