Skip to content
⚠️ Staging environment, test only, not production
Sign In
Structure9 min read

Preserving the Xactimate Project Tree: Why Flat PDF Scopes Fail Multi-Floor Commercial Losses

A flat PDF scope hides the room, floor, and trade structure of a commercial loss. Here is how the Xactimate project tree disappears, and how it gets rebuilt.

Review required: AI-generated output requires professional review, verify every line item, price, and total before submission.

Chaz Jaco

Co-Founder & Software Architect, ESXPress

An Xactimate project tree is a hierarchy: the project holds structures, a structure holds floors, each floor holds rooms, and the rooms hold the line items. The PDF report flattens that into pages of sequential text. A 25-room fire loss becomes a wall of descriptions where room boundaries exist only as line breaks. Any estimator who has tried to navigate a large-loss supplement from a PDF alone knows the problem, the ESX file is the only faithful representation of the tree.

What the PDF strips away

The flat printout removes three structural properties the ESX file carries. First, the nesting itself, which room a line item belongs to, and which floor the room is on. Second, the partition of trades, water mitigation and mold remediation get printed as adjacent lines with no designation that they are different scopes with different standards. Third, the green custom item markers that show a line was manually entered or given a custom price. Each of these is recoverable in an import-ready ESX, and each is what makes the difference between a workable file and a retyping exercise.

Why structure matters to the bottom line

Insurance carriers and restoration firms review commercial losses by scope, not by page. When the supplement arrives as a tree with floors, rooms, and trade groups, the adjuster can see the damage narrative and price it in one pass. When it arrives as a flat list, the adjuster has to reconstruct the mental model, and the estimate gets reviewed more slowly, and more skeptically. On an 800-line estimate, that is hours of review time and a materially higher risk of a partial pay.

How the tree gets rebuilt

ESXPress reads the PDF page structure and reconstructs the grouping. Room headers that the report prints between sections become folders; column positions become quantity, unit, and price signals; repeated codes under a room inherit the room's group. The output ESX file carries the project tree, the line items, and the extended F9 notes as they were structured in the source, then the Completeness Advisor reviews the result. Every conversion goes through the same structural XML validation that Xactimate runs on import, so the file opens without the syntax surprise that a hand-built file risks.

What multi-floor losses expose

Small roof scopes hide the flattening; commercial losses expose it. On a single-floor residential claim, a flat list loses little because the reader can infer the rooms. On a multi-floor commercial claim, floor boundaries drive the drying bill, the material access, and the labor plan. Losing the tree there does not just cost review time, it mis-prices the job. The fix is not a better PDF reader, it is working the claim in its native structure, an ESX file.

Validating the rebuild before you submit

Once the ESX file is rebuilt, run it through the free ESX validator. It checks the file for broken codes and structural problems, and warns before Xactimate does. The validator also works on files you did not convert, which makes it a useful pre-flight check for any file coming in from an outside estimating service. For the reference side, the Xactimate glossary covers the folder, trade, and note terms that the tree exposes.

Related: PDF to Xactimate, and ESX project tree.

This post was drafted with AI assistance and reviewed for accuracy.

Xactimate is a registered trademark of Verisk Analytics, Inc. ESXPress is independent and not affiliated with or endorsed by Verisk/Xactware.

#project tree#multi-floor#commercial loss#room structure#xactimate#pdf scope#trade separation

Frequently Asked Questions

What is the Xactimate project tree?
The project tree is the hierarchy inside an ESX file: project, structure, floor, room, and the line items within each room. PDF reports flatten it into sequential text, which loses which room and floor each item belongs to.
Can a PDF scope be converted back to an ESX file with the tree intact?
Yes. ESXPress reconstructs the room and floor grouping from the PDF's printed structure and outputs an import-ready ESX file with folders, line items, and F9 notes restored, validated against the same structural checks Xactimate runs on import.
Why does the tree matter for commercial losses specifically?
Commercial claims run hundreds to thousands of line items across floors. Without room and floor boundaries, the adjuster has to reconstruct the model from a flat list, which slows review and raises the risk that trade scopes like water mitigation and mold remediation get blended.

Ready to convert PDFs to ESX in minutes, not hours?

Start free, no card required, 5 free conversions included. Upgrade to a paid plan for a 14-day trial (card required, no charge until it ends). First conversion in about two minutes.