---
title: "How to build easy-to-use forms in Confluence"
canonical: "https://support.appfire.com/space/RUN/73074996/How%20to%20build%20easy-to-use%20forms%20in%20Confluence"
format: markdown
---
> Macro (aura-html)

## Description

This example shows how to use the [Run macro](https://appfire.atlassian.net/wiki/spaces/RUN/pages/73074658) from Run Self-Service Reports for Confluence to configure the user form in Confluence. With the help of an organized form editor, quickly create the form with the required fields, and add buttons with custom button text to enhance the form usability.

## Requirements

- <u>[Run Self-Service Reports for Confluence](https://appfire.atlassian.net/wiki/spaces/RUN)</u>

# Macro browser input

## Select this macro

|  |  |
| --- | --- |
| **Macro name** | *Run with a user form and parameters* |
| **Macro syntax** | *{Run with a user form and parameters}* |

## Configure macro

Consider a Confluence page which includes the macro *Run with a user form and parameters*. To configure the macro, follow the macro parameter configuration and the steps below. 

| **Macro parameter** | **Value** |
| --- | --- |
| ***Field settings > Form rows*** | Add fields to build the form |
| ***Display Settings ***> ***Buttons > Show run button*** | Enabled |
| ***Display Settings ***> ***Buttons > Show a reset button*** | Enabled |
| ***Display Settings ***> ***Buttons > Show a clear button*** | Enabled |

1. Edit the macro, and under ***Field Settings****, *add the required field types and provide the field details to build the form. To add fields, click **Add field**.

> ℹ️ To know more about adding fields, field settings and display settings, refer [Run macro parameters](https://appfire.atlassian.net/wiki/spaces/RUN/pages/73074762).

2. Under ***Display settings > Buttons***, enable the buttons and provide the button text for **Reset** and **Clear**. 

![image](media://e78eaa61-162f-4ef1-884c-e7f2c813a540)

3. The form configured is as shown below:

![image](media://044e9e46-6b1e-46e3-8c2d-cdc1504a4314)

4. The form actions, **Submit**, **Reset** and **Clear**, are as illustrated below.

| **Form actions** | **Description** | **Illustration** |
| --- | --- | --- |
| **Submit** | The **Submit** button allows you to submit the field values.<br>The **Run** macro will render the newly entered values and replace the old values with the new ones. The Run output displays the values rendered. | ![image](media://7f2ab3a4-7725-4629-9d71-3d2066af3426) |
| **Reset** | The **Reset** button allows the user to reset all the field values.<br>- If the **RUN** action has previously not occurred, the field values get reset to the default values.
- If the **RUN** action has previously occurred, all the field values get reset to the entries provided for the latest **RUN** execution. | ![image](media://157678f7-b1ac-42db-b935-713ef70594ee) |
| **Clear** | The **Clear** button allows the user to clear the input provided for all the form fields.<br>- The values get set to the default field values.
- It also clears the **Run** output displayed for the latest **RUN** execution. | ![image](media://6665b837-eef1-4a64-9375-160c8b9e93dc) |

> ℹ️ To know more about **Submit**, **Reset**, and **Clear** parameters, refer to [Run macro parameters](https://appfire.atlassian.net/wiki/spaces/RUN/pages/73074762).