Community · Help

SheetApps User Guide

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

Currency & unit referenceReference

Required amounts and quantities. If a money or quantity field is required, its currency or unit dropdown is required too — but only when SheetApps can pre-fill it (a currency it detected, a default you set, or a unit filled in from a chosen product). That way a required picker never blocks saving a value it couldn't have guessed.

Where the dropdowns appear depends on the shape of your form:

Form shapeHow currencies & units behave
Header onlyA single set of fields, with no repeating lines. Each money or quantity field gets its own dropdown by the rules above, and the form can show several currencies at once.
Header + line itemsA header with a repeating line-items table. When the header — or a totals block such as Sub Total / Grand Total — carries a currency, the whole record uses one document currency: the dropdown sits on the header or totals and every line inherits it, with no currency dropdown on each row. Units can still differ line by line.
Grid, no headerColumns across the top with rows below and no separate header. SheetApps treats it as a single-record form (Header only, above), so each money or quantity column gets its own dropdown, and different currencies or units can sit side by side.
Document currency. A totals block or a header currency field tells SheetApps the money belongs to the whole document, so the record shows one currency instead of a dropdown on every line. A form with no totals and no header currency keeps a dropdown on each money field — useful when one record genuinely mixes currencies.

What the dropdowns are named. You rarely name these fields yourself — SheetApps adds them — but it helps to know their names when a rule, formula or default needs to refer to one:

DropdownField nameLabel
Shared currencycurrencyCurrency
A field's own currency<field>_currencyCurrency
Shared unitunit_of_measureUnit
A field's own unit<field>_unitUnit

Because the labels are always “Currency” and “Unit”, refer to a dropdown by its field name, not its label — for example default = HEADER.currency in a Rules default. A currency or unit code column you provide yourself keeps the name you gave it.

If two dropdowns would end up with the same name, SheetApps adds a number to keep them apart (currency_2, currency_3).
On dashboards. A flat-table widget shows each amount with its own currency symbol and each quantity with its unit, exactly like the records grid. A KPI, chart or pivot that combines records shows a symbol or unit only when they all share one currency or unit; a total that mixes currencies (or units) is shown as a plain number — adding different currencies isn't meaningful — with a small “mixed” note. Filter or group by currency to see per-currency totals. A dashboard-wide “Units & currency” toggle switches every value between its symbol/unit and a plain number.

In printed and PDF records, money shows with its currency symbol and quantities show with their unit — matching what you see on screen.