The naming convention that survives a desk review
Use a fixed field order and never skip a field, even when it feels redundant on a small claim. The pattern is claim number, elevation or location, category, then a two-digit sequence number: 24-0001234_Front_Slope_02.jpg. Keep the file name free of spaces and special characters; some upload paths in Xactimate® and XactAnalysis® truncate or reject names with slashes, colons, or apostrophes.
Elevation labels should match whatever elevation labels are already on the sketch or the roof measurement report, front, left, right, rear, so a reviewer can move between the photo folder and the sketch without translating terms. If a roof measurement report already carries slope labels, using those same labels on the photo file names keeps the sketch, the estimate line items, and the photo folder in agreement; see Sketch My Roof roof measurement reports for an example of a labeled slope diagram.
| Category | Example filename | What the photo must show |
|---|---|---|
| Elevation overview | 24-0001234_Front_Overview_01.jpg | The full elevation from ground level with the structure and roofline visible |
| Slope | 24-0001234_FrontSlope_02.jpg | The entire slope, ridge to eave, one photo minimum per slope on the sketch |
| Test square | 24-0001234_FrontSlope_TestSquare_03.jpg | A 10 ft by 10 ft marked boundary with the hail hits or damage count inside it clearly visible |
| Penetration or component | 24-0001234_FrontSlope_Vent_04.jpg | A single pipe jack, vent, skylight, or flashing detail, close enough to read the damage |
| Interior | 24-0001234_Interior_Attic_05.jpg | Decking, rafters, or ceiling staining, keyed to the same elevation label as the exterior finding above it |
| Overview or site context | 24-0001234_Overview_Address_06.jpg | House number, mailbox, or street sign confirming the property matches the claim address |
Shoot order: match the sequence to the sketch
Photograph and upload in the same order every time so the sequence numbers themselves carry information. A gap in the numbering, or a sequence that jumps from slope photos straight to interior photos with no test square in between, reads as a missing step even before the reviewer checks the estimate.
- Overview and address confirmation
Start with the full structure and a house number or mailbox shot so the file set opens on a photo that confirms the location.
- Elevation photos, one per side
Front, left, right, rear, in the order the sketch lists them.
- Full slope photos
One complete slope photo per facet named on the sketch, using the same slope label.
- Test square photos
One per slope where a test square was measured, with the boundary and the count visible in the frame.
- Penetration and component close-ups
Vents, pipe jacks, skylights, chimneys, and flashing, each as its own numbered file under the slope it sits on.
- Interior photos
Attic decking, rafters, or ceiling staining, labeled to match the exterior slope the damage traces back to.
- Supporting or supplemental photos
Anything ordered after the fact, gutters, siding, detached structures, added at the end of the sequence rather than inserted mid-set.
What a desk reviewer is actually checking for
- Every file uses one claim number and one elevation vocabulary
A reviewer cross-references the photo set against the sketch without opening every file individually.
- Test square photos show a full, countable damage pattern inside the marked boundary
The test square count is what the slope-wide damage estimate is built from; an unclear boundary invites a re-inspection request.
- Every slope named on the sketch has at least one full-slope photo
A missing slope photo is the fastest way to get a line item questioned or pended.
- Interior photos carry the same elevation label as the exterior finding they support
It ties the water path or the impact location to a specific slope instead of leaving the connection implied.
- Sequence numbers run without gaps
A missing number in the middle of a sequence reads as a deleted, replaced, or withheld photo, which slows approval.
Attaching the set to the estimate and to XactAnalysis®
Rename the whole folder before you import anything; it is far faster than renaming files one at a time inside the estimate. Menus vary by version, so verify the exact click path in your build against the vendor's own documentation before relying on these steps.
- Rename and group the photo folder
Apply the naming convention to every file first, then confirm the sequence has no gaps and no duplicate numbers.
- Attach via the estimate's photo or sketch panel
In Xactimate®, photos are attached at the line-item or roof-facet level through the estimate's photo import option; consult the official help center for the current menu location in your version.
- Attach at the assignment level for XactAnalysis® routing
When the file is routed through XactAnalysis®, attach the labeled set to the assignment so the photos travel with the file to every party who opens it, rather than living only inside a local estimate copy.
- For Symbility® files, use the claims documentation attach step
Symbility® handles photo attachment through its own claims documentation workflow; the naming convention transfers directly since it is file-name based, not platform based.
- Keep an independent copy in the claim folder
Save the labeled set outside the estimate software as well, so the photo record survives even if the estimate file is later revised or replaced.
Version and platform caveats
Xactimate® desktop builds and the browser-based version place the photo attach option in different spots, and that location has moved across recent releases. Symbility® versions differ by build as well. Treat every click path in this guide as generic and confirm the current menu in your own software before training a team on it.
The naming convention itself is version independent because it lives in the file name, not in any one platform's photo panel. That is the main reason to standardize on file names rather than relying on whatever caption or tag field a given version happens to offer that year.
Frequently Asked Questions
What is the best way to label photos for Xactimate®?
Do test square photos need anything besides the damage?
Should interior photos use a different naming pattern than exterior photos?
Where do labeled photos get attached, the estimate or XactAnalysis®?
Does the naming convention change between Xactimate® and Symbility®?
Sources
- Photo attachment at the line-item and estimate level in Xactimate®, and menu locations that vary by version: Xactware Help Center, Xactimate® documentation (as of August 2026)
- Attaching photos at the assignment level so documentation travels with a file routed through XactAnalysis®: Xactware Help Center, XactAnalysis® documentation (as of August 2026)
- Symbility® claims documentation and photo attachment workflow: CoreLogic Symbility® claims documentation (as of August 2026)
- Roof measurement report slope labels used as a consistent elevation vocabulary for photo naming: Sketch My Roof residential order page (as of August 2026)