Form specification
Every Form_ sheet describes one form. Sheetward reads the sheet's layout to work out the fields, their order and the form's shape — this page shows the layouts it supports, from a quick single-section form to the classic header-plus-line-items document.
Form title. Enter the form's display title in cell A1 and leave an empty row below it. The title becomes the form's heading in the app, and the empty row tells Sheetward where the title ends and the fields begin.
Field names across one row; sample values in the rows below
| A | B | C | D | |
|---|---|---|---|---|
| 1 | Part Stock | |||
| 2 | ||||
| 3 | Part | Price | Quantity | Location |
| 4 | CPU Fan | $50 | 10 | Austin |
| 5 | RAM | $500 | 75 | Dallas |
One field per row — the name in column A, a sample value beside it
| A | B | |
|---|---|---|
| 1 | Part Stock | |
| 2 | ||
| 3 | Part | CPU Fan |
| 4 | Price | $50 |
| 5 | Quantity | 10 |
| 6 | Location | Austin |
Header first (pairs or columns); the LINE ITEMS table below it, always in columns
| A | B | C | |
|---|---|---|---|
| 1 | Invoice | ||
| 2 | |||
| 3 | HEADER | ||
| 4 | Invoice No | INV-001 | |
| 5 | Customer | Acme Corp | |
| 6 | |||
| 7 | LINE ITEMS | ||
| 8 | Item | Qty | Amount |
| 9 | Widget | 3 | $75 |
| 10 | Gadget | 1 | $120 |
Single-section forms — one set of fields, two ways to write them:
- Fields in columns. Field names across one row, with sample values in the row (or rows) beneath — one column per field, like a small table. Sample values are used only to detect each field's data type; they are never imported as records.
- Field : value pairs. One field per row — the field name in column A with a sample value beside it. Reads like a paper form.
Two-section forms — the classic document: a header (one record) with a repeating line-items table beneath it, marked with HEADER and LINE ITEMS rows:
- Header section: its fields may use either arrangement — columns or field : value pairs.
- Line-items section: always the column arrangement — a row of field names above the item rows, placed below the header section.
HEADER and LINE ITEMS rows make your intent explicit — use them whenever a layout could be read more than one way.