---
title: "Require parameters"
canonical: "https://support.appfire.com/space/CDML/649529809/Require%20parameters"
format: markdown
---
> Macro (aura-html)


## Overview

If the destination state has been configured to require setting one or more workflow parameter values, the workflow state dialog box displays a warning for the transition.

Once a parameter value has been set, it is not prompted for again unless the saved value is removed

> ℹ️ The **Require parameter**s option is only for approval transition actions, and state **Submit** transition or state **Select** transition actions. Requiring parameters is not a feature for other actions, such as task-related actions.

### User state transition - select and submit transition

When the **Require parameters** option is set for the destination state, a **Select** transition and **Submit** transition from another state require the parameter values.

For the transition option to a single state, the **Submit** button displays a warning icon.

![image](media://f748107e-1565-44ee-9aa3-de5aa97cf037)

Choosing the **Submit** button opens a box to enter the value of the required workflow parameter.

![image](media://a07e9ae4-230d-4511-9136-a2ad1c490519)

The **Change state** button is enabled when a value for the workflow parameter is added.

> ℹ️ The **Select** transition in the state also displays a warning icon when the destination state has been configured to **Require parameters**.

### Approval transition

If the destination state requires setting one or more workflow parameters, an approval decision button with a warning icon is displayed.

![image](media://2ada9afc-e538-437a-a181-691faa038f1f)

Choosing the approval decision with the warning icon opens a box to enter the value of the required workflow parameter(s).

![image](media://960aae3f-4d35-4a6d-aab6-5a045c1b8881)

The decision button is enabled when a value for the workflow parameter is added.

> ℹ️ Required parameters are only prompted if a user performs a workflow action, such as approving or rejecting an approval or state selection. If a state transition is caused by a trigger, a page update, or a task-related action, there is no **Require parameters** check.

## See also

[User Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648907144):

- [Select a state](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650216987)
- [Progress tracker](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649825888)
- [Content reviews](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650313809)

[Workflow Authoring Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648611901):

- [Require parameters on state transitions](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649793313)

| [‹ Back to Workflow state dialog box](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649659846) |
| --- |