> For the complete documentation index, see [llms.txt](https://developer.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.collibra.com/workflows/creating-workflows/workflow-basic-configuration-elements/workflow-dialog-boxes.md).

# Workflow dialog boxes

The most common scenario for dialog boxes is when you need to provide data in a workflow start form before the workflow starts.

## Start forms

When the start event of your workflow has a form reference, a dialog box appears before the start of the workflow. You must fill in the required information or accept the default values and submit them to start the workflow. If you close the dialog box instead of submitting the form, the workflow does not start. If you do not provide the required information and continue, the workflow starts but might not complete.

If you start a workflow from another workflow or via the API, you must provide the required information for the start forms with your request to start the workflow. In these cases, the workflow cannot generate a dialog box to request the information.

## User tasks

There are some scenarios where the dialog boxes appear automatically for user tasks. These happen when the next available user task is assigned to the same user who has just:

* Completed a start form.
* Started a global workflow without a start form.
* Completed another user task in a dialog box.

For these scenarios to work, all of the following conditions must be met:

* You either start the workflow on the resource page for which the workflow is configured, or you use a global workflow.
* Any script tasks that are between the start form and the next available task or between a task in a dialog box and the next available task are completed.
* You do not close the first dialog box before the second one appears.
* The start form or user task in a dialog box and the next available task belong to the same workflow process and neither is part of a sub-process.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.collibra.com/workflows/creating-workflows/workflow-basic-configuration-elements/workflow-dialog-boxes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.