Workflow states

Published

November 27, 2025

Workflow states are statuses unique to a specific workflow.

Workflow states are discrete from model stages.1

Prerequisites

Manage workflow states

Add workflow states

Add workflow states by either while configuring a Workflow State Change step,4 or via the Settings page:

  1. In the left sidebar, click Settings.

  2. Under Workspace, select Workflow States.

  3. Select the tab for the type of state to add:

    • Model Workflows — Workflow states that apply to model workflows.
    • Artifact Workflows — Workflow states that apply to artifact workflows.
  4. Click on the workflow you’d like to modify workflow states for.

  5. Click Add Workflow State.

  6. Enter in a name and a description, then select a color for your workflow state.

  7. Click Save to create the workflow state.

Edit workflow states

  1. In the left sidebar, click Settings.

  2. Under Workspace, select Workflow States.

  3. Select the tab for the type of state you want to edit:

    • Model Workflows — Workflow states that apply to model workflows.
    • Artifact Workflows — Workflow states that apply to artifact workflows.
  4. Click on the workflow you’d like to edit the states for.

  5. Hover over the workflow state until Edit Details appears, then click on it.

  6. Make your changes to the name, description, and color for your workflow state.

  7. Click Save to apply your changes.

Delete workflow states

ImportantWorkflow state deletion is permanent.

If a state is or was previously in use on a workflow within a Workflow State Change step, the state cannot be deleted.

  1. In the left sidebar, click Settings.

  2. Under Workspace, select Workflow States.

  3. Select the tab for the type of state you want to delete:

    • Model Workflows — Workflow states that apply to model workflows.
    • Artifact Workflows — Workflow states that apply to artifact workflows.
  4. Click on the workflow you’d like to delete workflow states for.

  5. Hover over the workflow state until Delete Workflow State appears, then click on it.

  6. After you confirm, the workflow state will be removed.