> For the complete documentation index, see [llms.txt](https://docs.incident-tracker.com/llms.txt). Every page is available as Markdown by appending `.md` to its URL.

# Manage Forms

Build custom forms with rows, columns and fields for Incident Tracker reports, control when forms load or stack, and unlock forms marked as hidden.

Source: https://docs.incident-tracker.com/admin-guide/application-information/manage-forms

Incident Tracker allows administrators to create, assign, and customize forms used during report submission. These forms can collect structured data specific to categories, locations, or user-triggered criteria.

---

## Creating and Managing Forms

To create or modify forms:

1. Navigate to **Admin > Manage Forms**.
2. Click **Create New Form** or select an existing one.
3. Create form rows and columns:
   * Add fields like textboxes, dropdowns, checkboxes, and more.
   * Organize fields using rows and columns.
4. Click **Save** to finalize.

> **Warning**
>
> Forms in use already can only be edited on a limited basis. Adding or removing fields will require a new version of the form to be created.

### ▶️ Interactive tutorial - Creating a Custom Form

*Walks through creating a new form, adding fields, and saving it.*

[▶️ Interactive tutorial - Creating a Custom Form](https://app.arcade.software/share/EKCWu4PbiJVUsJyCaDJy)

### ▶️ Interactive tutorial - Rows in Forms

*Shows how to add and organize rows in a form.*

[▶️ Interactive tutorial - Rows in Forms](https://app.arcade.software/share/KDTFOB24IRkDfEzfmXQe)

### ▶️ Interactive tutorial - Columns in Forms

*Shows how to add and organize columns in a form.*

[▶️ Interactive tutorial - Columns in Forms](https://app.arcade.software/share/imVaYEbSnClIfLrjFryT)

---

> **Tip**
>
> Common Format/Styling attributes include:
>
> * font-size: 14px;
> * font-weight: bold;
> * text-decoration: underline;
> * font-style: italic;
> * color: blue; (any common color name)
> * text-align: center; (left, right)
> * padding-bottom: 10px; (add spacing between the next row)

---

## Form Assignments

To learn how to assign forms based on category or location, see:\
🔗 [**Form Assignments**](https://docs.incident-tracker.com/admin-guide/application-information/manage-forms/form-assignments)

---

## Form Usage Settings

Under **Manage Forms**, each form includes a **Usage Questions** configuration section that controls how and when the form is displayed.

#### Usage Options (dropdown):

1. **Forms are off**\
   – The form will never appear during report submission.
2. **Forms are only loaded when triggered by a category or location selection (see assignments)**\
   – The form only shows if the report matches an assignment.
3. **Forms are loaded when triggered OR can be loaded manually by the user**\
   – The form will show based on assignment or the user can choose to add it manually.

#### Additional Settings:

* ⬜ **Allow Forms to Stack**\
  Enables users to load multiple forms simultaneously on a single report.
* ⬜ **Allow Assigned Forms to Be Removed**\
  Lets users remove forms that were auto-assigned via rules.

> **Note**
>
> These settings allow greater flexibility in how forms are applied and whether users can manage them manually during submission.

---

## Using Forms in Reports

Once assigned and configured:

* Forms appear automatically during report submission if matched to category/location.
* Users can fill out one or more forms based on system logic or manual selection.

> **Caution**
>
> Forms are not required by default. Be sure your team understands which forms are expected and when.

### Locked Forms and Hidden Settings

If a form is locked and cannot be edited when viewing a submitted report, it’s likely due to a visibility setting on the **Manage Forms** page.

#### Why This Happens

When a form is marked as **hidden**, it will still appear in the report but with a **lock icon** in the top left corner. This prevents users from modifying its contents during report editing.

#### How to Fix a Locked Form

Administrators can unlock the form by following these steps:

1. Go to **Admin > Manage Forms**
2. Select the form from the dropdown
3. Uncheck the **“mark as hidden”** checkbox
4. Click **Save**

> **Warning**
>
> If the form is currently in use across multiple reports, only limited edits will be allowed.

> **Warning**
>
> Once unhidden, the form becomes fully editable in all associated reports, depending on user permissions.
