---
title: "Edit workflow parameters"
canonical: "https://support.appfire.com/space/CDML/649792431/Edit%20workflow%20parameters"
format: markdown
---
> Macro (aura-html)
## Overview
[Workflow parameters](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649760641) can be added to a workflow to allow the workflow to be used flexibly across different spaces or teams without having to update your workflow for each use.
A workflow parameter acts as a placeholder for a value that has not yet been created or can change.
The workflow parameter can be used by the workflow. For example, for the approval below, the **Design Team **workflow parameter value is added as the mandated reviewers
The workflow parameter is referenced by adding the parameter name wrapped in the** @** operators. In our example, **@Design Team@**.
You can
- create a workflow parameter with one of a number of different value types, such as user values, group values, text string, a duration period, a date, or a set list of values
- set a workflow parameter so its value(s) can be edited by a user
- set a default value to be used by the workflow
Adding a default value for a workflow parameter means that when the workflow is added to a space, the workflow parameter is added to the [space tools Parameters dashboard](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649726501) and is editable at the space level by the space admin.
A workflow parameter is a type of [value reference](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694302).
Examples of the use of a workflow parameter include
> Macro (contentbylabel)
## Edit the workflow parameters using workflow builder
You can use the workflow builder to add [workflow parameters and their values](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649760641).
Workflow parameters can be accessed in the workflow builder [workflow panel](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649529902).
The number of workflow parameters in the workflow is listed. If none are present **+add** option is displayed
## Parameter editor
Choose **Parameters** in the [workflow panel](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649529902).
Existing workflow parameters are listed by name with (if present) the parameter description and set parameter value.
Choose the parameter name (if present) to open the parameter editor.
Use the parameter editor to amend the
- parameter name (required)
- type of parameter value (required)
- parameter value (optional)
- parameter description (optional)
Choose the checkbox to allow users to edit the parameter value using the page tools menu on the page.
If a default value is added for the workflow parameter, it can be viewed in the space tools Document Management dashboard, and space admins can edit the parameter value for the space.
> 📝 Editing a parameter value in the workflow builder may not change the value used by a space workflow. If the parameter value is different in the space parameters dashboard, the value held in the dashboard is used when the space workflow is first applied to content in the space.
## Add a workflow parameter
To open the **Add parameter** panel select one of the following:
- **+add** (or the current number of parameters) in the workflow panel
- **+Parameter** in the parameter list panel
- **+Parameter **lozenge in the navigator panel
To create a new workflow parameter, you must
- Add a name for the workflow parameter
- Select the type of parameter value from the dropdown menu
You can optionally
- Add a parameter description
- Add a default value for the parameter
> 📝 When you add a default value, the workflow parameter is added to the space tools parameters dashboard and its value can be edited by the space administrator.
Check the **Editable** checkbox to allow users to change the parameter value.
## Types of workflow parameter
| **Type** | **Icon** | **Value** |
| --- | --- | --- |
| **string** |  | Text string |
| **user** |  | Comma-separated list of one or more Confluence usernames |
| **group** |  | Comma-separated list of one or more Confluence group names |
| **duration** |  | Use the parameter editor value type dropdown menu to set one of the following formats
- **Period** in one of years, months, years, days, hours, minutes or seconds
- **ISO 806**1 format time period
- **Fixed Date**
- **Value reference** |
| **list** |  | To add a **list** parameter type
- Add a parameter name
- Choose **options** in the **Type **dropdown menu to add your list items
To add each list item, in the **Options **dialogue box:
- Type the option name
- Use a comma to add a new option
Each added list item is a dropdown option choice in **Value** for the default parameter value in the workflow:
 |
After any changes, ensure that you
- Choose **Add** in the state editor to confirm the changes for the state.
- Choose **Save** in the navigator panel to add these changes to the workflow.
> 📝 When adding a space workflow, a [parameter reference](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649760641) value is only available for use by the workflow after a workflow process event, such as a transition
For example, to avoid blocking your workflow, the initial state should not include using the parameter reference value for a due date or pre-assigned reviewers for approvals. Alternatively, you can choose to [Initialize states](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649827807) when applying a space workflow.
## Related pages
- [https://appfire.atlassian.net/wiki/spaces/CDML/pages/649924594](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649924594)
- [https://appfire.atlassian.net/wiki/spaces/CDML/pages/650316391](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650316391)