Measurement tokens and categories (Settings)

See the standard tokens such as @roof.total_area_sqft, add categories and tokens for the things your estimators capture, and disable the ones you never use.

Advanced 6 minOwner / manager· Last checked 2026-10-03

Video tutorial coming soon

The written steps below are complete. Producing the video? Use the video script tab — it follows these steps one for one.

GuideGuide Video scriptScript Test checklistChecklist

Tick each line only when the screen shows exactly what is described. Anything else is a finding: note the step number, what you saw, and the browser you used.

Screens covered: /settings?activeTab=measurement-settings · Guide last checked 2026-10-03

0 of 5 ticked · remembered in this browser

Preconditions

Default measurement settings, with one custom token to add on camera.

Steps

1. Open Measurements settingsDo: Go to Settings → "Measurements" (activeTab=measurement-settings).Expect: Heading "Define the tokens your estimators capture…" with categories Roof, Wall, Siding and Openings, and buttons "Add Category", "Edit Category" and "Add Token".Actual:
2. Read the Roof tokensDo: Expand Roof. Note token keys such as total_area_sqft, waste_percent, ridge_lf and their units.Expect: Each token shows a key, label, unit and an enable/disable control.Actual:
3. Add a tokenDo: Click "Add Token", choose a category, give it a label and key, and pick a unit: Square, Square Feet, Linear Feet, Each, Piece, Gallon, Hour, Bundle, Percent, Roll, Box or Text.Expect: The token appears in its category and is available to formulas as @<category>.<key>.Actual:
4. Disable what you never useDo: Toggle off tokens that do not apply to your business.Expect: Disabled tokens stop appearing in the formula token picker.Actual:

Result

Tester

Date

Build / environment (staging URL + git commit)

Browser & device

Notes / findings

Related lessons

Measurements explained: snapshots, active and Quote-Safe

The mental model behind roof measurements: where numbers come from, what a snapshot is, why only one is active, and how measurements reach a quote without silently changing it.

Roof measurementsIntermediate6 min

Pricing methods: automatic vs manual, and quantity formulas

Understand how automatic pricing is computed, when a manual override makes sense, and attach a quantity calculation so a product's quantity comes from roof measurements.

Price list & pricingAdvanced10 min

Finished this lesson?