Incomplete step

An Incomplete Step is shown when a Flow cannot continue. It gives the user a controlled error page instead of leaving the process in an unclear state.

Use an Incomplete Step when the problem is not something the user can correct directly, such as a backend failure, missing prerequisite, or process state that prevents completion.

Properties

Name	Description	Default	Mandatory
description	Translation key or Markdown text shown as the main description	Default incomplete description	No
reason	Translation key or Markdown text shown as the failure reason	Default incomplete reason	No
restart_button	Show a button that restarts the Flow	Hidden unless configured	No
restart_button.text	Translation key or text for the restart button	forms.incomplete.restart	No
proceed_button	Show a button that sends the user to another URL	Hidden unless configured	No
proceed_button.text	Translation key or text for the proceed button	forms.incomplete.proceed	No
proceed_button.url	URL opened when the proceed button is clicked	N/A	Yes, when proceed_button is used
proceed_button.open_in_new_tab	Open the URL in a new browser tab	false	No
proceed_button.logout	Log out the user when the proceed button is clicked	false	No

Default example

{}

Buttons example

{
  "restart_button": {},
  "proceed_button": {
    "url": "/launchpad"
  }
}

Custom text example

{
  "description": "forms.external_user.incomplete.description",
  "reason": "forms.external_user.incomplete.reason",
  "restart_button": {
    "text": "forms.external_user.incomplete.restart"
  },
  "proceed_button": {
    "text": "forms.external_user.incomplete.proceed",
    "url": "/launchpad",
    "open_in_new_tab": false
  }
}

Traceability

The Incomplete Step can show the request trace_id. This helps support staff and administrators find the corresponding backend logs when troubleshooting.