The Deep Cleanup -- Pre-Milestone Model Optimization
Comprehensive model cleanup sequence for project milestones.
The Deep Cleanup
Before project milestones -- SD submissions, DD submissions, permit sets, or CD packages -- run this cleanup sequence to optimize your Revit model. A clean model prints faster, syncs faster, and produces fewer surprises when others open it.
Estimated time: 30-60 minutes depending on model size and number of issues found.
Quick-Start Checklist
- Run ReViewer and record baseline metrics (warnings, file size, view count)
- Analyze warnings with Warning Center, prioritize critical/high
- Remove duplicate elements with Find Duplicates
- Remove overlapping lines with Overkill
- Consolidate duplicate materials with Merge Material
- Swap non-standard types with Type Swap
- Enforce workset standards with Workset Conform
- Purge unused elements with Wipe Hub
- Re-run ReViewer and compare against baseline
flowchart LR
A["1. Assess\nHealth"] --> B["2. Analyze\nWarnings"]
B --> C["3. Remove\nDuplicates"]
C --> D["4. Remove\nOverlapping"]
D --> E["5. Consolidate\nMaterials"]
E --> F["6. Swap\nTypes"]
F --> G["7. Enforce\nWorksets"]
G --> H["8. Purge\nUnused"]
H --> I["9. Verify\nResults"]
style A fill:#3b82f6,color:#fff,stroke:#2563eb
style I fill:#10b981,color:#fff,stroke:#059669Step 1: Assess Current Health
Tool: ReViewer
Start by understanding where you stand. Open ReViewer to see the dashboard of project metrics.
What to look for:
- Warning count: Anything over 500 deserves attention. Over 2000 is urgent.
- File size: Compare to previous audits. Unexplained growth indicates bloat.
- View count: Projects with 500+ views often have many unused views that should be purged.
- Family count: A high family-to-instance ratio suggests unused families.
Record these numbers. You will compare them after cleanup to measure improvement.
Step 2: Analyze Warnings
Tool: Warning Center
Open Warning Center to understand the warning landscape. Use its warning visualization surfaces to see which warning types are most prevalent and which severity tiers matter most.
Action items:
- Critical warnings (red): Fix these first. They typically indicate overlapping walls, duplicate elements, or room boundary issues that affect calculations.
- High warnings (orange): Schedule fixes for these. They include things like slightly off-axis elements and unjoined walls.
- Medium/Low warnings: Address in bulk where possible. Many can be resolved by the tools in the next steps.
Use the Deep Scan button to run PerformanceAdviser rules for additional insights beyond standard warnings.
Step 3: Remove Duplicate Elements
Tool: Find Duplicates
Duplicate elements are a common source of warnings and visual artifacts. Run Find Duplicates to scan for identical elements in the same location.
Typical duplicates found:
- Walls on top of walls (from copy/paste or linked model coordination)
- Double-placed furniture families
- Overlapping detail lines from copied detail views
Review the results list and delete the duplicates. Each deletion may resolve multiple warnings.
Step 4: Remove Overlapping Lines
Tool: Overkill
Run Overkill on views with heavy detailing. It finds congruent lines, filled regions, and detail items that overlap exactly.
Best practice: Run Overkill on a few representative detail views first. If it finds significant duplicates, run it across all detail views.
Step 5: Consolidate Materials
Tool: Merge Material (Modeling Panel)
Duplicate materials accumulate over the life of a project, especially when importing families from external libraries.
- Open Merge Material
- Click Scan Duplicates to auto-detect similar materials
- Review each pair: pick the survivor (target) and the redundant one (source)
- Click Simulate to preview changes before committing
- Click Merge to execute
- Use Purge Unused to delete materials with zero usage
Step 6: Swap Non-Standard Types
Tool: Type Swap
If your project has accumulated non-standard text styles, dimension styles, or line styles, use Type Swap to consolidate them.
- Open Type Swap
- Select the Text tab (or Dimensions, Lines, etc.)
- Map each non-standard type to its standard replacement
- Click Swap to replace all instances
Step 7: Enforce Workset Standards
Tool: Workset Conform
Run Workset Conform to move misplaced elements to their correct worksets. This step is particularly important for workshared projects where multiple users may have created elements on the wrong workset.
Step 8: Purge Unused Elements
Tool: Wipe Hub
Wipe Hub is the final cleanup step. Work through each category:
- Unused Views: Delete views that are not on any sheet and are not needed for coordination
- Unused Filters: Remove filters not applied to any view
- Unused View Templates: Remove templates not assigned to any view
- Unused Linked Models: Unload and remove links no longer needed
- Imported CAD: Remove leftover DWG imports
Step 9: Verify Results
Tool: ReViewer
Return to ReViewer and compare the new metrics against your Step 1 baseline.
Expected improvements:
- Warning count reduction of 20-50%
- File size reduction of 5-15% (after compact and save)
- View count reduction reflecting purged unused views
Save or export the audit results for your project records. This data demonstrates quality management to project leadership.
Tips
- Run Compact Central after the deep cleanup for maximum file size reduction.
- Schedule cleanups at regular intervals (monthly or at each phase gate), not just before deadlines.
- Assign ownership: In multi-user projects, designate one person to run the deep cleanup to avoid conflicts.
- Always audit first: Never run cleanup tools without understanding what they will affect. ReViewer and Warning Center provide that understanding.
See Also
- The Complete Guide to Revit Warnings - every warning type explained with remediation advice
- The BIM Governance Loop - how cleanup fits into a systematic governance process
- Your First Model Audit - 15-minute walkthrough for first-time audits
- Health Panel - full reference for all audit and cleanup tools
Last updated: 2026-04-16