---
title: "Organize Your Form and Structure"
slug: "form-builder-organize-your-form-and-structure"
updated: 2026-10-28T14:24:19Z
published: 2026-10-28T14:24:19Z
canonical: "help.quickbase.com/form-builder-organize-your-form-and-structure"
---

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

# Organize Your Form and Structure

Every FastField form is built from pages, sections, and fields. This article explains how these parts fit together in the Form Builder, and how field keys identify each field.

## How a form is structured

A form has 3 layers.

| Layer | What it is |
| --- | --- |
| Page | A step in the form. Users move between pages with the next and previous controls |
| Section | A titled group of related fields on a page. Users see the section name and description |
| Field | A single question or piece of data, such as text, a photo, or a signature |

For example, a work order form can have a *Work Order Details* section with *Title*, *Description*, and *Priority* fields. A long inspection can split into one page per area of a site.

![](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/organize-01-canvas-structure.png?sv=2026-02-06&spr=https&st=2026-10-30T02%3A44%3A23Z&se=2026-10-30T03%3A44%3A23Z&sr=c&sp=r&sig=4Q5R30l2Qa8jZ7rc8Hsc%2BXh7S90odoP%2BM%2FrnTLCk%2F1U%3D)

*A form on the canvas with the page name, a section, and its fields highlighted*

A short form can live on one page with a few sections. For a long form, group related sections onto separate pages so users can work through it step by step.

## View and change the structure

The Pages & Sections tab lists every page and the sections on each page.

1. In the Form Builder, select **Pages & Sections** in the side bar.
2. Select a page or section to jump to it on the canvas.

![](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/organize-02-pages-sections-tab.png?sv=2026-02-06&spr=https&st=2026-10-30T02%3A44%3A23Z&se=2026-10-30T03%3A44%3A23Z&sr=c&sp=r&sig=4Q5R30l2Qa8jZ7rc8Hsc%2BXh7S90odoP%2BM%2FrnTLCk%2F1U%3D)

*he Pages & Sections tab listing the pages and sections of a form*

From this tab you can:

- **Add a page or section:** Select **Page** or **Section**
- **Rename a page or section:** Select the edit icon next to its name
- **Change section settings:** Select the settings icon next to a section
- **Reorder:** Drag a page or section to a new position

Learn more about how to [reorder sections and fields](/fastfield/docs/en/form-builder-reorder-sections-and-fields).

## Name and describe a section

1. Select the more options icon in the section header, then select **Section Settings**.
2. Enter a **Section Name** and an optional **Section Description**.
3. Select **Save Section**.

![](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/organize-03-section-settings.png?sv=2026-02-06&spr=https&st=2026-10-30T02%3A44%3A23Z&se=2026-10-30T03%3A44%3A23Z&sr=c&sp=r&sig=4Q5R30l2Qa8jZ7rc8Hsc%2BXh7S90odoP%2BM%2FrnTLCk%2F1U%3D)

*Section Settings with Section Name, Section Description, and Section Key*

Section Settings also has the **Section Key**, which identifies the section. Here you can also make the section repeatable. Learn more about [repeating sections](/fastfield/docs/en/form-builder-create-and-use-repeating-sections).

## Field keys

Every field has a field key, a unique ID for the field in the form. FastField assigns a field key when you add a field, for example *alpha_1* for a Text field. Two fields in the same form can't share a key.

Field keys connect a field to the rest of FastField. Submissions, calculations, scripts, reports, and integrations use them to find the field's value.

To view or change a field key:

1. Select a field on the canvas.
2. In Field Settings, select the **General** tab.
3. Change the value in **Field Key**. It can contain only letters, numbers, and underscores.

![](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/organize-04-field-key.png?sv=2026-02-06&spr=https&st=2026-10-30T02%3A44%3A23Z&se=2026-10-30T03%3A44%3A23Z&sr=c&sp=r&sig=4Q5R30l2Qa8jZ7rc8Hsc%2BXh7S90odoP%2BM%2FrnTLCk%2F1U%3D)

*Field Settings for a Text field with the Field Key setting*

> [!WARNING]
> Important
> 
> Set field keys before you publish. Changing a key later can break calculations, scripts, reports, and integrations that use the old key.

> [!NOTE]
> Tip
> 
> To see every field key on the canvas, select **Settings** in the bottom toolbar, then turn on **Show Fieldkeys**.

![](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/organize-05-show-fieldkeys.png?sv=2026-02-06&spr=https&st=2026-10-30T02%3A44%3A23Z&se=2026-10-30T03%3A44%3A23Z&sr=c&sp=r&sig=4Q5R30l2Qa8jZ7rc8Hsc%2BXh7S90odoP%2BM%2FrnTLCk%2F1U%3D)

*The canvas with Show Fieldkeys turned on, showing the field key next to each field type*

## Reference a field value

To use a field's value in a calculation or a script, wrap its field key in $ characters. For example, this formula multiplies a quantity by a unit price:

`$quantity$ * $unit_price$`

## Organize the form with the Assistant

You can ask the Assistant to restructure your form. It can add, rename, move, and delete pages and sections, and group fields into new sections.

1. Select **Assistant** in the side bar.
2. Describe the change, for example *Split this form into 3 pages* or *Group the contact fields into a section called Customer*.
3. Send the message.

The Assistant can also change field keys. To work on one section, select the Assistant icon in its header.

> [!NOTE]
> Note
> 
> Assistant changes aren't saved until you select **Save Draft**.

## What's next

- [Reorder sections and fields](/fastfield/docs/en/form-builder-reorder-sections-and-fields)
- [Create and use repeating sections](/fastfield/docs/en/form-builder-create-and-use-repeating-sections)
- [Field type overview](/fastfield/docs/en/form-builder-field-type-overview)