Project measurements & formulas

Guides, permissions, workflows, and company operations.

Use this guide to configure measurement units, measurement values, and measurement formulas in Company settings so project duration and estimate math are easy to maintain.

Where to configure

  • Company settings → Measurement settings
  • Sections: Measurement units, Measurement values, Measurement formulas

Quick definitions

  • Units: reusable input keys users can enter on projects (example: sqft, coats, rolls).
  • Values: reusable constants (example: coverage_per_pint, waste_pct).
  • Formulas: calculated outputs using unit inputs + values (example: paint pints, labor hours, material quantity).

Recommended setup order

  1. Define units first.
  2. Add values/constants used across jobs.
  3. Create formulas that reference those units/values.
  4. Create/edit a project and enter measurement inputs to validate the formula preview.

Input formats

Measurement units (one per line): key | label | category | aliases(optional)
sqft | Square Feet | area | sq ft,sf
coats | Coats | count
rolls | Rolls | count
Measurement values (one per line): key | value | unit_key(optional) | label(optional)
coverage_per_pint | 120 | sqft | Coverage per pint
waste_pct | 10
Measurement formulas (one per line): key | name | expression | output_unit(optional)
paint_pints | Paint Pints | (sqft * coats * (1 + (waste_pct/100))) / coverage_per_pint | pint
labor_hours | Labor Hours | paint_pints * labor_hours_per_pint | hour

How this connects to project planning

  • Projects can store measurement inputs (key/value pairs).
  • Those inputs + company values/formulas feed the project math engine.
  • The resulting duration contributes to project schedule and calendar forecasting.

Tips / guardrails

  • Use snake_case keys (example: coverage_per_pint).
  • Keep key names stable; changing keys can break existing formulas.
  • When possible, start from a measurement preset and then fine-tune.
  • After changes, test with a draft project and verify the formula preview output.