Alpha Health Check
Running diagnostic checks on your Revit model before exporting
Health Check
The Health Check tool runs a series of diagnostic checks on your Revit model to detect common issues that could affect export quality or cause failures.
Running a Health Check
- Open the Revit model you want to check
- Click Health Check in the Tools panel of the Alpha ribbon
- The checks run automatically and a results dialog appears
Health Score
The results dialog displays an overall health score from 0 to 100:
- Pass checks receive full credit
- Warning checks receive half credit
- Error checks receive zero credit
- Info checks are informational and do not affect the score
Checks Performed
| Check | Category | What It Detects |
|---|---|---|
| Document Warnings | Document | Revit document-level warnings. More than 200 triggers an error. |
| Group Integrity | Model Groups | Empty groups and nested groups that may cause export issues. |
| DWG/DXF Imports | Document | CAD imports that can bloat GLB file size. More than 5 triggers an error. |
| In-Place Families | Families | In-place family instances that may not export cleanly. More than 10 triggers an error. |
| Missing Materials | Materials | Materials without appearance assets, which may render incorrectly in 3D. |
| Duplicate Group Names | Model Groups | Multiple group types sharing the same name, which can cause copy failures. |
| Model Statistics | Statistics | Total element count, family count, and top categories (informational). |
Interpreting Results
Each check shows:
- Severity — Pass, Info, Warning, or Error
- Count — Number of issues found
- Description — Summary of the finding
- Details — Expandable list of specific items (up to 50)
Recommendations
- Run a health check before exporting to catch issues early
- Address Error items first as they are most likely to cause export failures
- Warning items are worth reviewing but may not block exports
- Use the Model Statistics check to understand model complexity
Severity Thresholds
| Check | Warning Threshold | Error Threshold |
|---|---|---|
| Document Warnings | 1-200 | > 200 |
| DWG/DXF Imports | 1-5 | > 5 |
| In-Place Families | 1-10 | > 10 |
| Missing Materials | 1-5 | > 5 |
| Duplicate Group Names | — | Any duplicates |
| Group Integrity | Any issues | — |