Version History
Track changes to your takeoff over time with version history. Save named checkpoints, compare them, and restore a previous state when needed.
Overview
Version history helps you:
- Save named checkpoints of your takeoff progress
- See who saved each checkpoint and when
- Compare any two checkpoints, or a checkpoint with the current saved sheet
- Restore a previous checkpoint if needed
This is especially useful for collaborative projects or when experimenting with different takeoff approaches.
Accessing Version History
- Open a document in the takeoff editor
- Click the Version history icon in the header of the Takeoff details panel on the right
- The panel switches to Saved measurements, listing the checkpoints for the open sheet
Checkpoints belong to the original file and sheet. Use the Sheet selector to look at another sheet, or the whole takeoff.
Finish or cancel the current drawing before opening history. BuildVision saves checkpoints automatically around risky moments; manual saves let you create named checkpoints.
Saving Versions
Manual Save
To create a named checkpoint:
- Click Save version in the history panel
- Enter a Version label (e.g., "Before client changes" or "After electrical review")
- Click Save version
Auto-Save
BuildVision automatically saves checkpoints:
| Checkpoint | When |
|---|---|
| After editing | At the end of an editing session |
| Before AI run / After AI run | Around each AI takeoff on the sheet |
| Before clear / After clear | Around clearing the sheet's measurements |
| Backup before restore / Restored | Around a restore |
Viewing the Timeline
Each checkpoint in the list shows:
| Field | Description |
|---|---|
| Checkpoint | Its number and what created it (manual label or auto-save reason) |
| Items | How many measurements it holds |
| Date and author | When it was saved and by whom |
Older sheets may show legacy checkpoints, which are for comparison only and cannot be restored.
Comparing Versions
Compare any two checkpoints, or a checkpoint with the current saved sheet, to see what changed between them.
- Choose the Baseline checkpoint
- Choose what to Compare with (another checkpoint or Current saved sheet)
- Click Compare measurements
Each row in the list also has a Compare button that compares that checkpoint with the current saved sheet.
Scale changes affect all measurements. If many items differ after a scale change, verify the new scale is correct.
Restoring Previous Versions
To restore an earlier checkpoint:
- Select the checkpoint in the history panel
- Click Restore checkpoint
- Confirm Restore measurements
A backup of the current sheet is saved first, then the checkpoint's lines, markups and the sheet's scale come back.
Best Practices
Save before major changes: Create a named checkpoint before bulk edits or significant manual work. AI runs get their own checkpoints automatically.
Use descriptive names: "Reviewed by John 11/15" is more helpful than "Version 5".
Compare before restoring: Always compare to understand what you'll gain and lose.
Keep milestone versions: For long projects, create checkpoints at key milestones (e.g., "Scope review complete").
Next Steps
- Manual Editing - Make changes to your takeoff
- Results & Measurements - Understanding your data
- Exporting Data - Create external backups