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, computed as the rounded average over all non-Info checks:
- Pass checks receive full credit (100)
- Warning checks receive half credit (50)
- Error checks receive zero credit (0)
- Info checks are informational and are excluded from the score
Checks Performed
Eleven checks run, in this order:
| 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. |
| Face-based Families in Groups | Model Groups | Face-based (work-plane-based) family instances that are members of a model group. A known trigger of the native m_big2SmallMap2 / "Fix Groups" failure when the configurator merges multiple source RVTs via CopyElements — the cross-document dependency walker follows the family's host-face reference out of the group. Any occurrence is an error. |
| Cross-group Hosting | Model Groups | Hosted family instances whose host element lives in a different group than the instance (or only one of the two is grouped). The other well-documented trigger of native CopyElements failures during cross-document merge. Any occurrence is an error. |
| 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 Appearance Assets | Materials | Materials without appearance assets, which may render incorrectly in 3D. More than 5 triggers an error; counts of 5 or fewer still report Pass. |
| Duplicate Group Type Names | Model Groups | Multiple group types sharing the same name, which can cause copy failures. |
| Duplicate Family Names | Families | Multiple loaded families sharing the same name, which can cause Revit CopyElements mapping failures. |
| Duplicate Family Type Names | Families | Multiple family symbols sharing the same family/type name pair, which can cause Revit CopyElements mapping 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 (truncated for large counts)
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 |
| Group Integrity | Any issues | — |
| Face-based Families in Groups | — | Any occurrences |
| Cross-group Hosting | — | Any occurrences |
| DWG/DXF Imports | 1-5 | > 5 |
| In-Place Families | 1-10 | > 10 |
| Missing Appearance Assets | — | > 5 (1-5 reports Pass) |
| Duplicate Group Type Names | — | Any duplicates |
| Duplicate Family Names | — | Any duplicates |
| Duplicate Family Type Names | — | Any duplicates |