Workflow & Task States

Workflows and tasks in the WorkLyft system have two layers of statuses:

  1. Technical statuses – managed automatically by the workflow engine.

  2. Business statuses – user-facing, configurable by administrators.

This distinction ensures the engine can reliably track process execution, while users see business-friendly labels that make sense in daily operations.

Workflow Technical Statuses

Status
Description

running

Workflow is active, at least one task created and is in progress.

done

Workflow completed successfully (all tasks finished, skipped, or cancelled).

cancelled

Workflow was cancelled.

error

Workflow ended due to at least one task finishing with error.

Task Technical Statuses

Status
Description

active

Task created and is currently in progress (manual or system execution).

done

Task finished successfully.

skipped

Task was bypassed (e.g. condition not met, activation policy).

cancelled

Task was cancelled manually

error

Task failed (e.g. script error).

Business Statuses

  • Business statuses are configurable by administrators through General Settings -> Workflows in Admin Dashboard

  • They represent states meaningful to end-users (e.g. “In review”, “To sign”, “Approved”).

  • Business statuses are mapped to technical statuses, but allow organizations to adapt terminology to their processes.

Example mapping:

  • Technical: active → Business: “In review”

  • Technical: done → Business: “Approved”

How Statuses Interact

  • The workflow engine drives technical statuses automatically.

  • Users update business statuses in manual tasks.

  • Administrators define available business statuses per category, including which are ending statuses (used to determine process completion).

Last updated