---
title: "Configure Workflows"
url: "https://developer.incode.com/dashboard-platform-administration/configure-workflows/"
section: "dashboard-platform-administration"
group: "Workflows"
version: "v1.1"
status: "live"
---
# Configure Workflows

Workflows define the identity verification journeys your users complete. In your Workflows, you can combine user-facing modules, background processes, conditions, and results. Refer to [Workflows Overview](/concepts-and-architecture/workflows/) to understand the core concepts behind Workflows.



Workflows are created and configured in Dashboard. In the left menu, click **Flow Builder** > **Workflows**. You must have the appropriate role and permissions to create and edit Workflows. 


<Accordion title="Expand to view image">

<Image src="https://developer.incode.com/assets/a0bcfb0d0b3108e693ede874de7dfce6.png" alt="The Workflows page in Dashboard, displaying a table of configured workflows, their publish dates, and statuses." align="center" />

</Accordion>


There are two Workflow builder views: **New** and **Classic**. Use the toggles in the top right of your Workflow to set your view. New view introduces a redesigned builder that makes complex workflows easier to create and understand. In New view, you can:

- Follow workflows from left to right on a canvas that arranges itself automatically.
- Identify conditions without opening them.
- Add steps from a searchable catalog.
- Navigate large workflows using zoom and fit-to-screen controls.
- Catch configuration issues before publishing.







***

## Workflows Table

The following table describes the columns in the Workflows table.

| Column | Description |
|---|---|
| Workflow | The name of the Workflow. |
| Date Created | The date the Workflow was created. |
| Last Published | The date the latest version of the Workflow was published. |
| Sessions | The number of identity verification sessions started with the Workflow. |
| Status | Whether the Workflow is active or paused. Active Workflows can start new sessions; paused Workflows cannot. |
| Actions | Displays an icon for [testing](#test-workflows) the Workflow, [copying](#copy-workflow-ids-and-urls) the Workflow's ID and URL, [exporting](#export-workflow-configurations) Workflows, [pausing](#pause-workflows) and [reactivating](#reactivate-workflows) Workflows, and [deleting](#delete-workflows) Workflows. |



### Filter the Workflows Table

You can filter the list of Workflows by one or more criteria to find the Workflow you need.

1. In Dashboard, click **Flow Builder** > **Workflows** in the left menu.
2. Click **Add Filter** in the top left.
3. Select a filter: **_Workflow Name_**, **_Created at_**, **_Published at_**, or **_Number of sessions (more than)_**.

<Accordion title="Expand to view image">

<Image src="https://developer.incode.com/assets/351920035a980f43399a2a899b22d4b2.png" alt="Add Filter is clicked, and the Workflow name, Created at, Published at, and Number of sessions options appear." align="left" wrap={true} />

</Accordion>

<Accordion title="Expand to learn more about filters">

| Filter                         | Instructions |                                                                                                                                     
| ------------------------------ | ----------------------------- |
| Workflow Name                  | Enter the **Workflow Name**.  |                                                                                                                 
| Created at                     | Click **Start Date** and use the calendar to select a date. Do the same for **End Date**. This filter does not allow selecting specific times. |
| Published at                   | Click **Start Date** and use the calendar to select a date. Do the same for **End Date**. This filter does not allow selecting specific times. |
| Number of Sessions (more than) | Enter a number or use the arrows to set the number of Sessions that used a Workflow.                                                   |

</Accordion>

4. Enter or select the filter value.
5. Click **Apply**. The list displays the Workflows that fit the filter criteria.
6. Repeat these steps to add additional filters. To remove a filter, click **X** in its badge.

## Create Workflows

Create a Workflow to define the onboarding or authentication experience your users complete. Build the journey from Session Start to a result by adding:

- **Modules**: Identity verification screens your users interact with, such as capturing a photo of their ID or a selfie.
- **Processes**: Modules for background processes. Your users don't interact with these. They perform checks, such as document classification and authenticity audits, that help determine the Workflow's result.
- **Conditions**: Branching decisions that determine the path the Workflow takes. You can use conditions to present different modules to a user and determine the Workflow's result. For example, if the name on a user's driver's license doesn't match the name on their passport, you can use a condition to send them to a module that asks for a third form of ID. If none of the names match, you can specify a fail result. 

Before you start building, use [this index of modules](/features-and-modules/modules-overview-and-availability/) to determine which modules and processes you want to include in your Workflow.





1. In Dashboard, click **Flow Builder** > **Workflows** in the left menu.
2. Click **New** in the top right.
3. Click **Edit** ![Icon of a pencil](https://developer.incode.com/assets/c7e8dede-8700-4f17-89b8-5d4dfdcc219b.png#inline) in the top left and enter a new, descriptive name for this Workflow.
4. Do one of the following, depending on whether you have the **New** or **Classic** view enabled in the toggle in the top right:
    - **New**: Add your first module between Session Start and Session Pass. Choose one of the suggested first steps or click **Browse all modules** to see more options. You can search for a specific module name.
    - **Classic**: In the Modules panel, hover over each module for an overview of what it does and how it appears to the user. Drag modules onto the canvas to build your Workflow. You can also click **Select a template** on the canvas or **Templates** in the bottom left corner to start from a [template](#choose-a-workflow-template-standard-dashboard-only).

<Accordion title="Expand to view image of Classic view">

<Image src="https://developer.incode.com/assets/48967fcee4c710986aec2f2b73c645ce.png" alt="The cursor hovers over the ID Capture module, and a short description and image of the module's user experience appear." align="center" />

</Accordion>

5. Next to the module you added, click **Options** ![Icon of three dots stacked on top of each other](https://developer.incode.com/assets/aae0f87a-5c54-4fd9-b4a1-cc33d8a95099.png#inline) > **Edit** and configure the module settings.
6. Click **Save configuration**.
7. Click **Add node** ![Icon of a plus sign](https://developer.incode.com/assets/104e9c43-dab0-45e0-a16e-8cf34b9f8715.png#inline) to add another module, a process, or a condition. Processes and conditions must come after a module.

<Accordion title="Expand to view image of Classic view">

<Image src="https://developer.incode.com/assets/ad03a654223d270ca60a51897c3e8ed3.png" alt="A series of module, process, and condition nodes ordered top to bottom, first to last." align="left" wrap={true} />

</Accordion>

9. Configure and save the settings of each module, process, and condition.
10. Configure the overall [Workflow settings](#configure-workflow-settings).
11. To delete a module, process, or condition, click **Options** ![Icon of three dots stacked on top of each other](https://developer.incode.com/assets/aae0f87a-5c54-4fd9-b4a1-cc33d8a95099.png#inline) > **Delete**.
12. To change a final decision node, click **Options** ![Icon of three dots stacked on top of each other](https://developer.incode.com/assets/aae0f87a-5c54-4fd9-b4a1-cc33d8a95099.png#inline) next to it. Select a decision: _Pass_, _Fail_, _Warn_, or _Manual Review_, then click **Update Decision**.
13. If you have **New** view enabled in the toggle in the top right, click **Validate** in the top right and resolve any reported issues. Use the arrow next to **Validate** to switch between validating _All at once_ or _Step by step_.
14. When your Workflow is ready, click **Save & Publish**.
15. [Test the workflow](#test-workflows) and confirm every path behaves as expected.

### Choose a Workflow Template

Templates give you a starting point for the most common verification use cases. You can customize the Workflow or individual modules as needed. You can choose from the built-in template options or [import](#import-workflows) your own.

If you have **New** view enabled in the toggle in the top right, click **Templates** ![Icon of four white dots with gray borders forming a square](https://developer.incode.com/assets/2b907b22-ea5e-4f94-8363-f58145df8d9b.png#inline) at the bottom of the screen to select a built-in template.


<Accordion title="Expand to view image of Classic view">

<Image src="https://developer.incode.com/assets/7cb77abd1a82dce141afc855ee45c26d.png" alt="The list of built-in templates includes Blank, Identity verification, Step up age verification, one-to-many authentication step up, and one-to-one authentication step up." align="center" />

</Accordion>


The following templates are built in:

- **Identity Verification**: Includes the modules and processes needed to complete a standard ID-to-Face verification.
- **Step Up Age Verification**: Uses Face Capture to determine the user's age. If the user's age meets the condition set, ID Capture is not required for authentication. The default age threshold is 25 or older.
- **1:N Authentication Step Up**: Allows returning users to authenticate using just their face, compared against anyone's previous authentications. If authentication fails, the user is presented with an opportunity to complete ID verification.
- **1:1 Authentication Step Up**: Allows returning users to authenticate using just their face, compared against their own previous authentications. If authentication fails, the user is presented with an opportunity to complete ID verification.
- **Self-Service Reset & Recovery**: Verifies users’ identities for password resets, MFA resets, and Temporary Access Pass requests. It collects a login identifier, finds the user’s directory, and runs identity verification before routing them through the recovery process. This template is available in **New** view only.

## Import Workflows

Import a Workflow to reuse an exported Workflow configuration instead of rebuilding it manually. The import creates a new Workflow from a JSON configuration file.

1. In Dashboard, click **Flow Builder** > **Workflows** in the left menu.
2. Click **Import** in the top right.
3. Click **_Import File_** and select the JSON file you want to upload.

<Accordion title="Expand to view image">

<Image src="https://developer.incode.com/assets/e7854136d4d9c91372ff2f3380edb43c.png" alt="The fields in the Import pop-up include Import File and Workflow Name." align="left" wrap={true} />

</Accordion>

4. Enter a descriptive **_Workflow Name_**.
5. Click **Submit**.
6. Open the imported Workflow and review its modules, module configurations, processes, conditions, results, and [Workflow settings](#configure-workflow-settings).
7. Click **Validate** in the top right and resolve any reported issues. Use the arrow next to **Validate** to switch between validating _All at once_ or _Step by step_.
8. When your Workflow is ready, click **Save & Publish**.
9. [Test the workflow](#test-workflows) and confirm every path behaves as expected.

## Configure Workflow Settings

Workflow settings control the overall behavior and user experience of a Workflow.

1. In Dashboard, click **Flow Builder** > **Workflows** in the left menu.
2. Select a Workflow.
3. Click **Settings** ![Icon of a gear](https://developer.incode.com/assets/9773abfa-00c4-44b2-8a55-379ed8310adc.png#inline) in the top right.
4. Configure the settings in each section. Your changes are saved automatically.

<Accordion title="Expand to view the Workflow settings in each section">

**Deepsight**

| Setting | Description |
|---|---|
| **_Deepsight_** | Enables [Deepsight](/features-and-modules/deepsight/) for this Workflow. This setting is available only when Deepsight is enabled for your organization. It requires separate licensing. |

**Session Result**

| Setting | Description |
|---|---|
| **_Automatically create an identity on successful workflow execution_** | Creates an [Incode Identity](/get-started-with-incode/glossary/#incode-identity) automatically when the Workflow completes successfully. The identity is then available on the [Identities](/dashboard-platform-administration/view-identities/) page in Dashboard. |

**User Experience**

| Setting | Description |
|---|---|
| **_Skip intro screen_** | Sends users directly to the verification steps without displaying the launch screen. |
| **_Show verification result screen_** | Displays a final screen showing whether the user passed or failed verification. |
| **_Phishing Resistance_** | Protects against man-in-the-middle phishing attacks using dynamic QR codes and device-to-session binding. Enabling this setting also enables **_Redirect desktop attempts to mobile_**. |
| **_OAuth2 Secured (web only)_** | Protects the user journey against replay attacks using OAuth 2.0. A Redirect URL is required when this setting is enabled. |
| **_Redirect desktop attempts to mobile_** | Lets users who begin on a desktop transfer the verification to a mobile device. |
| **_Add continue to desktop_** | Gives users the option to continue the verification on their desktop instead of transferring it to a mobile device. |
| **_Redirect origin only_** | Redirects users only on the device where they started the verification. |
| **_Enable SMS_** | Lets users enter a phone number to receive the ID verification link by SMS. |
| **_Hide unsupported browser screen_** | Lets users continue without seeing the unsupported-browser screen. Only Chrome and Safari are officially supported. |
| **_Allowed devices_** | Restricts the Workflow to selected device types: <br>_Mini apps_: Lets users complete identity verification in a lightweight app without installing the full mobile application. <br>_Web mobile_: Lets users complete identity verification in a browser on their mobile device. <br>_Web desktop_: Lets users complete identity verification in a desktop browser, typically for remote or in-branch verification. |
| **_Enable SDK 2.0_** | Runs the web-based Workflow using Web SDK 2.0 instead of SDK 1.x, providing a modular architecture that loads components as needed for faster performance.  |
| **_Redirect URL_** | Specifies the URL users are sent to after completing the Workflow. This setting is required when OAuth2 Secured (web only) is enabled. |
| **_Log session as expired after timeout_** | Adds an expiration timestamp when a session reaches the configured time limit. Use this setting to monitor user behavior and completion rates around the expiration window. |

**Compliance & Privacy**

| Setting | Description |
|---|---|
| **_Age assurance_** | Displays privacy-adjusted tutorials. Incode stores no personally identifiable information other than the user’s date of birth. |
| **_Enable mandatory biometric consent_** | Requires users to provide biometric consent during the Workflow. |
| **_Store video of ID and face capture in session_** | Stores video recorded during the ID Capture and Face Capture modules in the session. |

</Accordion>

## Test Workflows

Test every path through a Workflow to confirm that its modules, conditions, results, and settings behave as expected.

1. In Dashboard, click **Flow Builder** > **Workflows** in the left menu.
2. In the Actions column for the Workflow you want to text, click **Test workflow** ![Icon of a QR code](https://developer.incode.com/assets/551b60b4-0122-43ea-9707-6fb44fe91063.png#inline).
3. Scan the QR code with your mobile device or click **Copy workflow link** ![Icon of a solid square overlapping a dashed square](https://developer.incode.com/assets/99d7251a-1ac8-4ece-8db1-9e1d4458e973.png#inline) and test in your browser.

## Additional Options


<Accordion title="Expand to view image">

<Image src="https://developer.incode.com/assets/83da446cc0a1282dd507a185a5a49609.png" alt="The three dots are clicked, and the following options appear: Pause Workflow, Copy URL, Copy ID, Export Config, and Delete." align="left" wrap={true} />

</Accordion>

### Copy Workflow IDs and URLs

Copy the Workflow URL to launch the Workflow or share it with users who need to complete it. Copy the Workflow ID when you need the Workflow’s unique identifier for an integration, an API request, or a support case.

1. In Dashboard, click **Flow Builder** > **Workflows** in the left menu.
2. In the Actions column for the Workflow you want, click **Options** ![Icon of three dots side by side](https://developer.incode.com/assets/e48bb4fb-08d6-4f8b-a9f7-eb883dc9c705.png#inline).
3. Select **Copy URL** or **Copy ID**.

### Export Workflow Configurations

Export a Workflow configuration to download its structure and settings as a JSON file. You can keep the file as a backup or [import it](#import-workflows) to create a new Workflow in another organization or environment.

1. In Dashboard, click **Flow Builder** > **Workflows** in the left menu.
2. In the Actions column for the Workflow you want, click **Options** ![Icon of three dots side by side](https://developer.incode.com/assets/e48bb4fb-08d6-4f8b-a9f7-eb883dc9c705.png#inline).
3. Select **Export Config**.

### Pause Workflows

Pause a Workflow to prevent users from starting new identity verification sessions with it. Use this option when you need to make changes or temporarily remove the Workflow from use. You can [activate it again](#reactivate-workflows) when it's ready.

1. In Dashboard, click **Flow Builder** > **Workflows** in the left menu.
2. In the Actions column for the Workflow you want, click **Options** ![Icon of three dots side by side](https://developer.incode.com/assets/e48bb4fb-08d6-4f8b-a9f7-eb883dc9c705.png#inline).
3. Select **Pause workflow**.

### Reactivate Workflows

Reactivate a paused Workflow to make it available for new identity verification sessions again. Before reactivating it, confirm that its configuration is current and [test each path](#test-workflows) to ensure it behaves as expected.

1. In Dashboard, click **Flow Builder** > **Workflows** in the left menu.
2. In the Actions column for the Workflow you want, click **Options** ![Icon of three dots side by side](https://developer.incode.com/assets/e48bb4fb-08d6-4f8b-a9f7-eb883dc9c705.png#inline).
3. Select **Activate workflow**.

### Delete Workflows

Delete a Workflow when it is no longer needed. Deletion is permanent and cannot be undone, so [export the configuration](#export-workflow-configurations) first if you may need to recreate or reference it later.

1. In Dashboard, click **Flow Builder** > **Workflows** in the left menu.
2. In the Actions column for the Workflow you want, click **Options** ![Icon of three dots side by side](https://developer.incode.com/assets/e48bb4fb-08d6-4f8b-a9f7-eb883dc9c705.png#inline).
3. Select **Delete Workflow**.