> ## Documentation Index
> Fetch the complete documentation index at: https://help.nextmatter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Forms and form fields

> Forms are detailed tasks required to complete a step. The form field might be to enter customer address or select a meal type from a dropdown. Each step can consist of multiple mandatory or optional form fields.

To cater to all types of data you might want to gather, there are multiple form types. For example, if you want to report a bug, You might want a user to enter a summary (short text input form field), describe a bug (long text input form field), select if the bug happened on mobile or desktop (radio form field), and possibly upload a screenshot (image upload form field).

This is what the user sees when they fill in such a workflow instance:

<Frame>
  <img src="https://mintcdn.com/nextmatter/bsmXZ466WcpOtxYo/images/docs/7bb250e-report_bug.png?fit=max&auto=format&n=bsmXZ466WcpOtxYo&q=85&s=b00eee07eb16aedf01c27772558edbf5" alt="Image showing a form" width="2857" height="1322" data-path="images/docs/7bb250e-report_bug.png" />
</Frame>

<br />

<Accordion title="Explore types of form fields">
  <CardGroup cols={4}>
    <Card title="Table" href="https://help.nextmatter.com/docs/tables-forms" />

    <Card title="Input fields" href="https://help.nextmatter.com/docs/text-fields" />

    <Card title="Routing" href="https://help.nextmatter.com/docs/routing" />

    <Card title="User selection" href="https://help.nextmatter.com/docs/user-selection" />
  </CardGroup>

  <CardGroup cols={3}>
    <Card title="Files, images, barcodes" href="https://help.nextmatter.com/docs/files-and-images" />

    <Card title="Drawing and signature" href="https://help.nextmatter.com/docs/drawing-and-signature" />

    <Card title="Dropdowns, radios and checklists" href="https://help.nextmatter.com/docs/single-and-multi-select-dropdowns" />
  </CardGroup>
</Accordion>

## Form configuration

You can work with form field configuration when you click on a step and add a form field.

<Frame>
  <img src="https://mintcdn.com/nextmatter/Z3-w3RiDibcpWWcE/images/docs/0d27896-Screenshot_2023-08-15_at_12.26.52.png?fit=max&auto=format&n=Z3-w3RiDibcpWWcE&q=85&s=ac787566379cdbfe7a86bf41d0a945a7" alt="Image showing how to configure a form" width="1468" height="676" data-path="images/docs/0d27896-Screenshot_2023-08-15_at_12.26.52.png" />
</Frame>

To configure form fields, do the following:

1. Go to **Workflows > Edit workflow**.

2. Click **Add step**.

3. Select **Form**.

4. Click **Add form field**.

5. Click the settings icon to add placeholders for fields or labels (step titles), and make the step optional.

<Tip>
  By default, form fields are required. If you want a field to be optional, you need to select **Optional** in the **Settings**.
</Tip>

There are also options to copy the form field ID, copy the form, move it (for example to a different step), and delete it.

<Check>
  Setting form conditions works in the same way as step conditions. For details, see [Set conditions to a step](/docs/set-conditions-to-a-step).
</Check>

## Edit a form field

After you've completed a form, you can still edit the fields if you're an admin or a user assigned to the step or if the step has been delegated to you.

If you go to the step (by following a link in the email), you can click the pencil icon, update your field data, and save your changes.

Notes:

* You can edit the step if the workflow hasn't been completed.

* If there are conditions related to the step or any other dependencies that have already been completed, updating the field doesn't change them.

* You can't update the completed step using the API.

<Frame>
  <img src="https://mintcdn.com/nextmatter/SgcAiYe3VpK6bFPP/images/docs/b7fddf5868c1ef4fdcbdcd2a152f28592d27166d0012b58d344307381c1c279d-edit.png?fit=max&auto=format&n=SgcAiYe3VpK6bFPP&q=85&s=b501939fa2bc5d1b18a74d9f7a0b6901" alt="Image showing how to edit a completed form" width="2940" height="1596" data-path="images/docs/b7fddf5868c1ef4fdcbdcd2a152f28592d27166d0012b58d344307381c1c279d-edit.png" />
</Frame>
