Attaching Workflows

    In this article, you can learn how to add extra functionality to your Form by attaching workflows.

    Workflows are a way of defining actions after your Form is submitted like sending an email or creating a content node.

    Default Workflow

    By default, when a Form is submitted the record data is stored in the database. This can be configured in the Store records of the Forms settings.

    The behaviour to display a message to the user that submitted the form, or to redirect to another page, can be configured by clicking on the built-in first workflow step, labelled Submit message/Go to page.

    Submit message/Go to page

    If a value is selected for Go to page it will be used to issue a redirect to that page once the form has been submitted.

    If no value is selected, the message provided in Message on submit will be displayed to the user on the same page, instead of the form fields. From version 8.8 onwards, this is implemented via a redirect to the current page, ensuring that the form can't be accidentally resubmitted.

    For either method, a developer can customize the page viewed after the form is submitted on the basis of the presence of a TempData variable with a key of UmbracoFormSubmitted and a value containing the Guid identifier for the submitted form.

    A similar TempData value is also available containing the GUID identifier of the record created from the form submission. You can find this using the Forms_Current_Record_id key.

    Adding a Workflow

    At the bottom of your Form, you can see which workflow is already attached to the Form, as well as an option to configure the workflows.


    Clicking Configure workflow will give you the option to configure existing workflows, as well as setup new ones.

    Workflow add

    Choose a Workflow

    A new workflow can be of different types and Umbraco Forms ships with a few default ones. You can find an overview of the types in the Workflow types article.

    Workflow add modal

    Update Type-specific Settings

    Once the Workflow Type has been selected, you will need to configure the workflow. There are various settings depending on the type that has been selected.

    To use data from the submitted Form in your workflow, head over to the Magic Strings article and learn more about how that's done.

    Fill in the settings and hit Submit. The workflow is added to your Form and it will be shown at the bottom of the page.

    Prev: Setting-up Conditional Logic on Fields                 Next: Workflow Types