Files list
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.
Field settings
To open the Files list field settings, select the field in the Field Group macro editor and click Edit ().
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. |
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. 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.
Need support? Create a request with our support team.