---
title: "Workflow Settings"
slug: "workflow-settings"
tags: ["workflow-builder"]
status: "update"
updated: 2026-10-13T15:37:06Z
published: 2026-10-13T15:37:06Z
canonical: "docs.unqork.io/workflow-settings"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unqork.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflow Settings

The **Workflow Settings** dialog configures a workflow's identity, end-user navigation behavior, canvas layout, custom messaging, save-and-exit behavior, and display options. To open it, click the ![EllipsisVertical](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153705_6bebfc4f5a81482d95d5c9325739fe22.svg?sv=2026-02-06&spr=https&st=2026-11-08T10%3A17%3A54Z&se=2026-11-08T11%3A17%3A54Z&sr=c&sp=r&sig=bfcwBbSksAIMsRkXbM%2BgJ1J85J57sbpM16PjSbfTY5k%3D) (**ellipsis**) in the Workflow Builder toolbar and select **Settings**, or right-click a workflow in the Explorer and select **Settings**.

## Workflow Info

| Field | Description |
| --- | --- |
| **Workflow Title** | The display name for the workflow as it displays in the UnqorkAI platform and the Explorer panel. |
| **Workflow Path** | The URL-safe identifier used in routing and API calls. |
| **Workflow Description** | A description of the workflow's purpose. |

## Express-user Navigation

Controls how end-users move through the workflow in Express.

### State Control

| Field | Description |
| --- | --- |
| **Auto State Control** | End-users follow a sequential, step-by-step . Every step is executed in order. The current step reflects the end-user's progress through the workflow. |
| ↳ | **Make Sequential Navigation Clickable** | When checked, this setting makes prior steps clickable so end-users can return to a completed step without losing their current position. Formerly known as Direct Navigation. |
| **Manual State Control** | End-users can navigate to any step at any time. Steps are not required to be completed in order, and the current step does not reflect progress. |

### Display Navigation As

Controls how workflow progress is displayed to end-users.

| Option | Description |
| --- | --- |
| **Steps** | Displays progress as a numbered list of steps. |
| **Percentage** | Displays progress as a percentage of steps completed. |

### Include in Navigation

Controls which tasks are counted toward the progress indicator.

| Option | Description |
| --- | --- |
| **All Tasks** | Counts all tasks in the workflow. |
| **All Tasks in Lane** | Counts only tasks in the end-user's current swimlane. |
| **All Tasks Until Lane Change** | Counts tasks up to the next swimlane transition. |

## Canvas Settings

| Setting | Description |
| --- | --- |
| **Enable Manual Layout** | When set to **ON**, this setting lets Creators reposition nodes freely on the workflow canvas. When set to **OFF**, the canvas uses automatic layout. Toggling this setting resets the current node positions. |

## Custom Messaging

Overrides default text for system-generated messages displayed during workflow execution.

| Field | Description |
| --- | --- |
| **Error Title** | The title displayed on the error dialog when a workflow error occurs. |
| **Error Message** | The body text displayed on the error dialog. |
| **Cancel Button Text** | The label for the cancel button in confirmation dialogs. |
| **Confirmation Button Text** | The label for the confirm button in confirmation dialogs. |
| **Default Lane Change Message** | The message displayed when an end-user transitions between swimlanes. |
| **Default Exit Message** | The message displayed when an end-user exits the workflow. |
| **Title** | The title displayed in the workflow header. |

## Save and Exit

Configures a Save and Exit button that lets end-users save their progress and leave the workflow before completing all steps.

| Field | Description |
| --- | --- |
| **Enable Save and Exit Button** | The button label displayed to end-users. |
| ↳ | **Save and Exit Label** | The button label displayed to end-users. |
| **Save and Exit Message** | The message displayed in the confirmation dialog before saving and exiting. |
| **Save and Exit Handoff Type** | Where the end-user is sent after saving and exiting. Options: **URL**, **Module**, or **Workflow**. |
| **Save and Exit Handoff URL** | The URL to redirect the end-user to after saving and exiting. Displays when **Handoff Type** is set to **URL**. |
| **Save and Exit Handoff Module** | The module to load after saving and exiting. Displays when **Handoff Type** is set to **Module**. |
| **Save and Exit Handoff Workflow** | The workflow to load after saving and exiting. Displays when **Handoff Type** is set to **Workflow**. |
| **Save and Exit Handoff Workflow Node** | The specific start node in the handoff workflow to begin from. Displays when a handoff workflow is selected. |

## Other

| Setting | Description |
| --- | --- |
| **Enable Vertical Navigation Display** | When set to **ON**, this setting renders the workflow's step navigation vertically instead of horizontally. |
| **Pass Non-Persisted Express Data to Automated Tasks, Gateways and Conditional Events** | When set to **ON**, this setting makes non-persisted client-side data available to automated nodes during workflow execution. When set to **OFF**, only persisted data is passed. |
| **Only Keep Persisted Data Upon Navigation** | When set to **ON**, this setting stores only persisted data in the client-side submission when end-users navigate between steps. When set to **OFF**, both persisted and non-persisted data remain available. To persist data, set a component's **Store Data in Database** toggle to **ON**. |
| **Enable Translations** | When set to **ON**, this setting activates translation support for the workflow. |
| **Validate When Navigating To Previous Step** | When set to **ON**, this setting runs field validation when an end-user navigates to a previous step. |

---

**Changelog**

| Date | Change |
| --- | --- |
| 2026-07-09 | Initial publication. |

End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product.

A URL (uniform resource locator) is a unique identifier used to locate a resource on the internet. Also known as a web address.

APIs (application programming interfaces) are a set of protocols and definitions developers use to build and integrate application software. APIs act as the connective tissue between products and services.

A definition

End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product.

The Unqork front-end application framework that delivers Creator-built applications to end-users. Express is the layer end-users interact with—the published forms, screens, and navigation built in the Module Builder. Express is distinct from Express View, which is a Creator-facing preview tool in the IDE.

End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product.

Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform.

Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field.

Rendering is the process of loading components and displaying the final result on the front-end screen.