The Cost Matching workflow takes a material schedule exported from Revit (or any compatible BIM tool) as a CSV file and automatically matches each material line to a unit cost from the built-in construction cost database. Results are grouped hierarchically by assembly, filtered by workset or building division, and can be compared across multiple versions of your takeoff — all without manual data entry.Documentation Index
Fetch the complete documentation index at: https://help.trytuuli.com/llms.txt
Use this file to discover all available pages before exploring further.
Preparing your CSV export from Revit
For the best matching results, your CSV should include the following columns. Column names are flexible, but the more context you provide the higher the match confidence.| Column | Purpose |
|---|---|
| Family | Revit family name — used for grouping and matching |
| Type | Variant within the family (e.g., Standard Modular) |
| Workset | Scope classifier (e.g., Interior, Exterior, Structure, MEP) |
| Assembly | Logical assembly name for hierarchical grouping |
| Quantity | Numeric quantity |
| Unit | Unit of measure (m², m³, LF, EA) |
| Manufacturer | Optional — improves match accuracy |
Uploading a file
Open the upload dialog
Click Upload on the Cost Matching page. A dialog gives you two choices:
- New file — start a fresh analysis with no version history
- New version of an existing file — attach the upload to an existing file so the version history sidebar tracks the change
Select your city
Choose the city or region that should anchor the cost data. Pricing varies by market, so selecting the correct city is important for accurate estimates.
What happens during processing
Processing runs in two sequential phases:- Parsing and cleanup — your CSV rows are parsed, material names are normalized, and ambiguous entries are classified. A progress bar shows the number of rows being cleaned.
- Cost matching — each cleaned material is matched against the cost database. The system reports the current material name and an overall progress count as it works through your schedule.
| Confidence | Meaning |
|---|---|
| High (green) | 80–100% match — the cost item is a strong fit |
| Medium (yellow) | 50–79% match — review before accepting |
| Low (orange) | 20–49% match — manual review recommended |
| Learned (purple) | Match was refined from a previous run on your workspace |
Viewing results
Hierarchical view
By default, results are grouped by assembly. Each group header shows the assembly name, the number of materials in the group, and the group subtotal. Click the expand arrow to see individual materials, their matched cost items, unit prices, quantities, and line totals.Table view
Switch to Table view using the toggle above the results to see all materials as a flat list. Table view is useful for scanning the full schedule or exporting a specific selection.The total estimated cost appears at the top of the results panel and updates in real time as you apply filters or exclude items.
Material presets and divisions
The filter panel on the left includes preset scopes that let you instantly narrow the estimate to a recognised construction division. Available presets include:Whole Building
All materials — the default unfiltered view.
Core and Shell
Structure, exterior envelope, and base-building systems.
Interior Fit-Out
Interior partitions, finishes, furniture, fixtures, and equipment.
Warm Shell
Core and shell plus tenant MEPF and base finishes.
Cold Shell
Structural frame and building envelope only, excluding mechanical fit-out.
Substructure
Foundations and below-grade construction.
Filtering results
Beyond presets, you can combine filters from the filter panel:- Worksets — limit to one or more Revit worksets (e.g., show only MEP materials)
- Families — filter to a specific Revit family name
- Assemblies — show a single assembly group
- Types — narrow to a specific family type
Editing unit costs manually
To override an AI-matched unit cost:Expand the material
Click the row expand arrow in hierarchical view, or find the material in table view.
Comparison mode
When you have two or more versions of a file, you can compare them side by side:Open version history
Click History to open the version history sidebar on the right. Each version card shows the file name, upload date, material count, city, and total cost.
Enable comparison mode
Click the Compare toggle in the results header. A second column appears alongside the current results.
Exporting results
Click Export in the results header to download the current view. Two formats are available:- CSV — a flat spreadsheet of all materials, quantities, matched costs, and totals. Respects the active filters so you can export a subset (for example, just the mechanical scope).
- DOCX — a formatted cost report document suitable for inclusion in bid packages or client deliverables.
Exports always reflect the currently active filters and any excluded items, so what you see on screen is what you get in the file.
Version history
Every upload creates a new version entry in the history sidebar. You can:- Load a past version to review its results
- Download the original CSV from any version card
- Delete a version you no longer need