---
title: "Parameters"
canonical: "https://support.appfire.com/space/CDMC/2192837939/Parameters"
format: markdown
---
> Macro (aura-html)

## Overview

In Comala Document Management, **workflow parameters** are placeholders that allow flexible values to be added to a workflow. They let you reuse the same workflow across different spaces without changing it.

The space administrator can set workflow parameter values for each space, allowing you to add and use those values without changing the workflow. This makes your workflow easier to manage and more adaptable across teams. 


> ℹ️ You cannot use a workflow parameter as a value for another workflow parameter.

## Where can you use workflow parameters

You can reference workflow parameters in the following areas:

- **Approvals**: Use parameters to dynamically define reviewers.
- **States**: Apply parameters to set values, such as state expiry dates.
- **Triggers**: Include parameters in trigger actions that support dynamic values.

## Parameter types

You can customize a workflow by adding one or more workflow parameters. When creating a parameter, you need to choose from several supported data types, depending on the kind of value you need. These parameters help make your workflows more flexible and reusable.

- **String**: A plain text value consisting of letters, numbers, or symbols.
- **User**: One or more Confluence usernames. Use this type to assign specific people to tasks or approvals.
- **Group**: One or more Confluence group names. Use this type to assign roles to teams or permission groups.
- **Duration**: A period or a specific date. Often used for setting state expiry or deadlines.
- **List**: A predefined set of values. Users can choose from this list when setting the parameter.

## Add a parameter

To add a parameter to your workflow:

1. Log in to your Confluence space.
2. Choose **Comala document management** under *Space Apps*.
3. Click **Create new workflow** or edit an existing custom workflow. For example, when editing an existing workflow, click the **Edit** icon next to the workflow you want to edit.
  This opens the [visual builder editor](https://appfire.atlassian.net/wiki/spaces/CDMC/pages/2193162438).
4. In the visual builder editor, click **Parameters** to add or edit a parameter.
5. You can click the existing parameter value and edit it, or click **+ Add Parameter** to create a new parameter.
6. In the **Add parameter **dialog, enter the following details.
  - **Name:** Enter a unique name for your parameter.
  - **Type: **Select a [parameter type](#Parameter-types).
  - **Label: **Enter a descriptive label for your parameter.
  - **Initial value:** Enter an initial value. When the workflow is first applied, this value is set by default.
  - **Description:** Enter a description for your parameter.
  - **Scope**: The `scope` attribute defines where a parameter’s value is accessible. This allows greater flexibility and control over how workflow parameters behave across a space or a specific page. See [scope options](#Scope-options) below for more details.

### **Scope options**

If** Scope** = **Workflow** (Default)

- The parameter is available **wherever the workflow is applied**.
- If the workflow is applied at the **space level**, the parameter is shared across all pages using that workflow in the space.
- If the workflow is applied at the **page level**, the parameter is available only to that page.

**Multiple workflows in the same space:**

Each workflow can use the same parameter name with **independent values**.

**Example:**

- `WorkflowA`: `Param1 = value1` → All pages using WorkflowA read `value1`
- `WorkflowB`: `Param1 = value2` → All pages using WorkflowB read `value2`

If **Scope = Page**

- The parameter value is **specific to each page**.
- You can view and edit these values directly in the [workflow dialog](https://appfire.atlassian.net/wiki/spaces/CDMC/pages/2193129918) on the page.
- Useful when the same workflow needs to behave differently depending on the page context.

See [Manage workflow parameters](#Manage-workflow-parameters) for more details.

## Working with page parameters

### **Page parameters and space settings**

Page parameters with `scope=page` are not displayed in the **Workflow Parameters** form within **Space Settings**. You can only edit them at the individual page level. 

![Workflow Parameters page in Space Settings displaying page-level parameter values.](media://3907c33a-f359-4652-94be-8ec3e935b572)

### **Initializing page parameters**

If page parameters have **not yet been configured** for a page, opening the **workflow dialog** displays a **Parameters initialization message**.  
This message includes:

- A brief prompt explaining that the parameters need to be set.
- A **Page Parameters** button to begin initialization.

### **Setting Page Parameters values**

After clicking the **Parameters** button:

- A form appears listing all **page-level parameter fields**.
- If initialization values are defined in the workflow, they will be pre-filled in the form.
- Users can review and customize these values before the workflow proceeds.

![Page Parameters dialog with Document Group Reviewers field and the Save Parameters button.](media://dfe6efd9-33f3-4868-9d1c-808a002c3760)

## Manage workflow parameters

Workflow parameters can be edited directly through the [workflow dialog](https://appfire.atlassian.net/wiki/spaces/CDMC/pages/2193129918) on the page. 

> ℹ️ This option is displayed when:
> ℹ️ 
> ℹ️ - There is no active space workflow in the space.
> ℹ️ - A page workflow that includes one or more workflow parameters is applied to the page

 To manage workflow parameters on the page workflow

1. Add a workflow to a page as a page workflow
2. Once the workflow is added, you can edit its parameters in the *workflow dialog *on the page.   
Click the **Workflow** **state byline > three-dot menu** () > ** Page Parameters **

3. In the *Workflow Parameters* dialog box, the current parameters values are displayed.  Edit the required values for the applied workflow.
4. Click **Save Parameters**.
  
  **Related topics**
  - [Workflow builder visual editor](https://appfire.atlassian.net/wiki/spaces/CDMC/pages/2193162438)
  - [Workflow state dialog](https://appfire.atlassian.net/wiki/spaces/CDMC/pages/2193129918)
  - [Approvals](https://appfire.atlassian.net/wiki/spaces/CDMC/pages/2193195490)