> ## Documentation Index
> Fetch the complete documentation index at: https://docs-terra.withunify.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Forms

> How to build forms using Terra's visual form builder

# Creating Forms

> The form builder provides a visual interface for creating complex, multi-language forms.

## Form Builder UI

The builder has three main areas:

```mermaid theme={null}
flowchart LR
    subgraph Builder
        Toolbox[Toolbox]
        Canvas[Canvas]
        Properties[Properties]
    end

    Toolbox -->|drag| Canvas
    Canvas -->|select| Properties
    Properties -->|update| Canvas
```

## Creating a New Form

1. Navigate to **Forms** → **New Form**
2. Enter a form name and slug (URL-friendly identifier)
3. Select a folder (workspace) or leave uncategorized

## Adding Fields

Drag fields from the toolbox to the canvas:

* **Input fields**: Text, Number, Date, Choice
* **Composite**: Address, Bank, Files, Signature
* **Display**: Info, Section, Divider, Image
* **Structural**: Group, Repeated

## Configuring Fields

Click a field to open the properties panel:

* **Label**: Display name (supports multiple languages)
* **Help text**: Additional guidance
* **Validation**: Required, min/max, patterns
* **Logic**: Conditional visibility
* **Layout**: Half or full width

## Multi-Page Forms

Click **+ Add Page** to create additional pages. Each page can have:

* Title
* Description
* Its own set of fields

## Archiving vs Deleting

* **Archive** keeps the form and its submissions but removes it from active lists.
* **Delete** is a **soft delete**: the form and submissions are hidden (marked with `deleted_at`)
  and can be restored by an admin if needed.

***

<CardGroup cols={2}>
  <Card title="Publishing" icon="rocket" href="/features/form-lifecycle/publishing">
    Draft and publish workflow
  </Card>

  <Card title="Field Types" icon="list" href="/core-systems/forms/field-types">
    Complete field reference
  </Card>
</CardGroup>