A workflow with a Form trigger has its own form page. Every submission starts a new run with the submitted values. This page describes what the people filling in the form see. How to set up the trigger is described under Form Trigger.
Who Can Open a Form
The form lives at /workflows/<workflow ID>/form. The Form URL is shown in the trigger's panel in the builder. Who may use it depends on the trigger's Access Control:
| Access Control | Who can submit |
|---|---|
| Private (Only owner) | Only the workflow owner, signed in. This is the default |
| Workspace (Members only) | Signed-in members of the workspace |
| Public (Anyone) | Anyone with the link, without an account |
Signed-out visitors of a form that is not public see Access Denied with a link to sign in.
The form only works once the workflow is deployed. Before that, visitors see Form Not Available Yet. If the workflow has been switched to inactive, they see Form not available with a note that the workflow is currently inactive.
Filling Out a Form
The form shows the title and description the author set, followed by the fields:
- Text and Multiline text
- Number, optionally with a minimum and maximum
- Date
- Dropdown: one option from a list
- Checkbox
- File upload: drag and drop or click to choose files
Required fields are checked before submission, and errors appear next to the field. Click Submit to send.
File Uploads
A file field shows which file types it accepts and how large a file may be. By default each file may be up to 10 MB. If the field allows several files, up to 5 can be attached by default. The workflow receives the files as file objects and can pass them on, for example as email attachments.
After Submission
After a successful submission the form shows the author's success message, by default "Thank you! Your submission has been received." The run then continues in the background. The form page does not show what the workflow produces.
Each submission starts its own run. Submitting the same form twice creates two runs.