Community · Help

Sheetward User Guide

Turn an Excel workbook (or Google Sheet) into a multi-user web app — forms, validation, lookups, import/export and more.

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.

Single section — fields in columns

Field names across one row; sample values in the rows below

ABCD
1Part Stock
2
3PartPriceQuantityLocation
4CPU Fan$5010Austin
5RAM$50075Dallas
Form_Parts
Single section — field : value pairs

One field per row — the name in column A, a sample value beside it

AB
1Part Stock
2
3PartCPU Fan
4Price$50
5Quantity10
6LocationAustin
Form_Parts
Two sections — header + line items

Header first (pairs or columns); the LINE ITEMS table below it, always in columns

ABC
1Invoice
2
3HEADER
4Invoice NoINV-001
5CustomerAcme Corp
6
7LINE ITEMS
8ItemQtyAmount
9Widget3$75
10Gadget1$120
Form_Invoice
In every layout: the form title sits in cell A1, with an empty row below it.

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.
Define the form once. A sheet that describes the same form twice — for example once as a column grid and once as pairs — is malformed: Sheetward stops with an error, because a line-items table can never come before the header. Keep a single definition per sheet.
When in doubt, add markers. The HEADER and LINE ITEMS rows make your intent explicit — use them whenever a layout could be read more than one way.