---
title: "How to configure new forms and wizards"
canonical: "https://support.appfire.com/space/PSJC/1839236408/How%20to%20configure%20new%20forms%20and%20wizards"
format: markdown
---
> Macro (aura-html)
---
## How to configure a single form
1. Log in to Jira as an Administrator.
2. Open **Apps** > **Manage apps** from your Jira Administration Settings.
3. Go to **Power Scripts **> **Configurations **>** Automations** > **Forms and Wizards**.** **
4. Click **Add form**.
5. In the *Add form configuration *dialog that opens, fill in the required information.
1. **Name**: Type a name for the new form.
2. **Description** (optional): Provide a short description about the new form.
3. Leave the **Buttons** toggle turned off as illustrated in the screenshot below:
4. Select the Jira projects where this form should appear.
5. Select the Issue types where this form should appear.
6. Select which side of the issue screen the form should appear on: the right or left column.
6. Click **Save**.
The form appears on the *Forms and Wizards**** ***configuration page*.*
7. To add the scripts for your form, click the **Edit scripts and steps** icon in the *Operations* column.
This opens the Form configuration page—a specialized version of the SIL Editor where you'll modify the three configuration scripts needed to define your form's behavior and appearance.
- The [Condition script ](https://appfire.atlassian.net/wiki/spaces/PSJC/pages/1839235280)determines how the form appears (or doesn't appear) to users in the selected issues. All contextual factors that determine visibility and state, such as user permissions, issue status, field values, or other conditions, must be explicitly defined within the condition script.
- The [Screen script](https://appfire.atlassian.net/wiki/spaces/PSJC/pages/1839235307) determines what is displayed on the form.
- The [Action script](https://appfire.atlassian.net/wiki/spaces/PSJC/pages/1839235954) determines what happens when the form is executed.
6. Modify each script and save the changes you made.
Once configured, the script files' color changes to green.
7. When ready, click **Back** to return to the *Forms and Wizards *page.
> ℹ️ For detailed information about each script, see the [Forms and Wizards configuration scripts](https://appfire.atlassian.net/wiki/spaces/PSJC/pages/1843396621) section.
---
## How to configure a wizard
You configure a wizard by adding one or more steps to a single form. In the Jira issue, wizards are displayed as a progression of steps that start from the main screen of a single form.
1. In your Jira admin console, go to **Power Apps Config **>** Advanced** >** Forms and Wizards**.
2. If you already have a configured form you want to turn into a wizard, locate the form in the list.
3. If you don’t have a configured form, complete the steps in the [How to configure a single form](https://appfire.atlassian.net/wiki/spaces/PSJC/pages/1839236408/How+to+configure+new+forms+and+wizards#How-to-configure-a-single-form) procedure.
4. In the *Operations**** ***column of the form’s listing, click the **Edit scripts and steps** icon.
5. To add a new step, click the plus sign icon.
A new set of scripts appears for the new step.
6. Configure each script type by clicking the **Save** button after modifying each script.
7. To add another step, click the plus sign icon again and configure the three script types for the step.
You can add as many steps as you need for your wizard, and you can also share values between wizard screens.
> ℹ️ You can configure a wizard so that certain values on a wizard screen depend on other values from another screen. These [additional functions](https://appfire.atlassian.net/wiki/spaces/PSJC/pages/1839236231) can help you configure the sharing mechanism.
8. When ready, click **Back** to return to the *Forms and Wizards *page.
---
## How to create a button-based configuration
The button-based approach works by creating an initial container form with buttons enabled and configuring a separate form or wizard for each button you add. This creates a hierarchy where the container form holds the buttons, and each button opens its own fully configured form or wizard. This way, each button serves as an entry point to its own complete form or wizard. When configuring a button, you're essentially creating a separate form that will open when that button is clicked.
> ℹ️ **Important:**
> ℹ️
> ℹ️ - The button-based configuration option can only be enabled during initial form creation. It cannot be enabled by editing an existing form.
> ℹ️ - You can add, delete, or update individual buttons at any time after creating a button-based form.
> ℹ️ - When buttons are enabled, you must configure at least one button during setup. Jira will display a warning message if you enable buttons but don't create any.
1. In your Jira admin console, go to **Power Apps Config **>** Advanced** >** Forms and Wizards**.
2. Click **Add form**.
3. In the *Add form configuration *dialog that opens, fill in the required information.
1. **Name**: Type a name for the new container form.
2. **Description** (optional): Provide a short description about the new form.
3. Turn the **Buttons** toggle on as illustrated in the screenshot below:
4. Select the Jira projects where this form should appear.
5. Select the Issue types where this form should appear.
6. Select which side of the issue screen the form should appear on: the right or left column.
4. Click **Save**.
The form appears on the *Forms and Wizards**** ***configuration page*. *As shown in the screenshot below, the buttons are enabled for this form:
5. To configure the buttons for your form, click the **Edit scripts and steps** icon in the *Operations* column. This opens the *Buttons**** ***page where you add and manage the buttons' configurations.
6. Click **Add button**.
7. Provide a name for the new button and save it. Optionally, you can provide a description.
8. To configure the new button:
1. Click the **Edit scripts and steps** icon in the *Operations* column.
This opens the specialized version of the SIL Editor, where you'll modify the Condition, Screen, and Action configuration scripts needed to define the behavior and appearance of the form associated with this button.
2. Modify each script and save the changes you made.
> ℹ️ Each button's visibility (enabled, disabled, or hidden) is controlled by its own Condition script, allowing for role-based access control.
9. Optional: To associate the button with a wizard, add steps to its form configuration.
10. When ready, click **Back** to return to the *Buttons *page.
11. Repeat steps 6 - 8 to add as many buttons as you need. Each button requires its own complete configuration with Condition, Screen, and Action scripts.
12. To change the order in which the buttons appear in the Jira issue, use the arrows in the *Order* column.
13. When ready with all button configurations, click **Back **to return to the *Forms and Wizards* page.
---
## How forms, wizards, and buttons appear in Jira issues
Based on your configuration's **Display mode** setting, your forms, wizards, and buttons will appear in different locations within Jira issues
| **Implementation** | **Example** |
| --- | --- |
| Right column single-form | - To display the form contents, click the **Power Scripts - Power Actions** link as shown in the screenshot below:
The form opens to display the available actions:
 |
| Right-column wizard | - A wizard configured to appear in the right-side panel of the Jira issue opens the same way as a single-form:
- Once the form is open, follow the wizard’s prompts to complete the action. |
| Left-side buttons configuration | - To display the contents of a form in the left-side panel (main body) of the Jira issue, click **Apps** icon, then select the **Power Scripts - Actions Panel** option:
The form opens to display the available actions. In this case, it reveals a set of buttons, each one leading to another form or wizard.
 |