> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-platform/2023-2/studio/form-builder/add-form-builder-task-to-workflow/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Add a Form Builder task to a workflow

> How to add a Form Builder ShowFormByName task to a workflow in legacy Itential Platform versions.

This is a legacy functionality in earlier Itential Platform versions. See the [Platform 6.0.0 Breaking Change](/itential-platform/release-notes/breaking-changes/form-builder-removed) notice.

This page covers how to add a **Form Builder** task to a workflow. It does not describe the functionality of the Workflow Builder application.

If you are not familiar with the Workflow Builder application, consult the relevant user guide before proceeding.

You can use Form Builder to add a form to a workflow, allowing users to enter information as part of the business process.

#### Open or create a workflow

Create a new workflow or open an existing one.

#### Add the ShowFormByName task

Select **FormBuilder** in the Source Application dropdown list. Select **ShowFormByName** and add it to the workflow.

![](/_fern-img/ed8a22605e7859846eb761462d44eda3fbde991a7db7de1fa15bed23971c34f0.webp)

#### Configure the manual task

Enter an appropriate summary and description, and assign it to the relevant User Group.

#### Configure the task variables

Configure the variables for the **ShowFormByName** task:

* **`form_name`** — The name of the form.
  * Set **Reference task** to `static`.
  * Enter the form name as the **Reference variable**.
* **`instance_data`** — If form values are entered by the user and are not populated by a previous task or external system:
  * Set **Reference task** to `static`.
  * Enter `{}` as the **Reference variable**.

![](/_fern-img/564cab75850e0655183a5a2042035b01fa209445e00d4c37c70eeceaf22f4f66.webp)

#### Save the workflow

Click **Update**, then **Save** the workflow.

#### Start the workflow and work the task

Click **Start workflow**. Navigate to the **Work queue** to view the task in the **Available Tasks** list. Click the task to initiate the work.

![](/_fern-img/d25cee8570ffe6849ba311d28c1dc574ea098c0180e959b460af903e29507235.webp)

**Outgoing data format example:**

```json
{
  "/ncs:services/itential_test_devices:cisco-ios": [
    {
      "device": [
        "csr01-atl"
      ]
    }
  ],
  "/ncs:services/aspan-vrf:aspan-vrf": [
    {
      "vpn-id": 1,
      "vrf-name": "vrfName",
      "route-target": [
        {
          "rt-export": [
            {
              "asn-ip": "1.1.1.2:33"
            }
          ]
        }
      ]
    }
  ]
}
```

The internal reference to a form field retains the original value before the field was renamed.

> How to add a Form Builder ShowFormByName task to a workflow in legacy Itential Platform versions.