Edit workflow parameters

Overview

Workflow parameters 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 and is editable at the space level by the space admin.

A workflow parameter is a type of value reference.

Examples of the use of a workflow parameter include

Page:

Require Parameters on a state transition — Require workflow parameter values to be set before moving into a workflow state.
Page:

State expiry dates — Using state expiry dates, defining them with metadata, and making them editable
Page:

Updating a mandatory reviewer for an approval assigned using a workflow parameter — Use workflow parameter as a mandatory assignee and the pageparameterupdate event to update the reviewer if the workflow parameter value changes
Page:

Using workflow parameters to create reviewer teams in a space — Using workflow parameters to create teams of users for use in approvals

Edit the workflow parameters using workflow builder

You can use the workflow builder to add workflow parameters and their values.

Workflow parameters can be accessed in the workflow builder workflow panel.

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.

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

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 8061 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 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 when applying a space workflow.