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.
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.
Tokens are the named measurements formulas refer to. The workspace starts with a standard set grouped into Roof, Wall, Siding and Openings. Add your own when your estimators capture something specific, such as skylight count or chimney flashing length.
By the end you can
- Read the default categories and tokens
- Add a category and a token with a unit
- Enable or disable tokens
Screens used
Step by step
Open Measurements settings
/settings?activeTab=measurement-settingsGo to Settings → "Measurements" (activeTab=measurement-settings).
You should see: Heading "Define the tokens your estimators capture…" with categories Roof, Wall, Siding and Openings, and buttons "Add Category", "Edit Category" and "Add Token".
Read the Roof tokens
/settings?activeTab=measurement-settingsExpand Roof. Note token keys such as total_area_sqft, waste_percent, ridge_lf and their units.
You should see: Each token shows a key, label, unit and an enable/disable control.
Add a token
/settings?activeTab=measurement-settingsClick "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.
You should see: The token appears in its category and is available to formulas as @<category>.<key>.
Disable what you never use
/settings?activeTab=measurement-settingsToggle off tokens that do not apply to your business.
You should see: Disabled tokens stop appearing in the formula token picker.
Tips
- Tokens added here are only filled when an import supplies them; for anything else, type the quantity on the quote line.
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?