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
Fourteen 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. |
| Reference Planes in Groups | Configurator | Reference Planes inside model groups: a known trigger for cross-doc copy failures (m_big2SmallMap2). Any occurrence is an Error. |
| Schedules in Source | Configurator | Schedules present in a source RVT; they bring project-wide rules into the merge unnecessarily. Any occurrence is a Warning. |
| Worksharing | Configurator | Document carries worksharing metadata. Source RVTs should be plain non-workshared files. Warning if active. |
| 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). |
The three Configurator-category checks, together with the two Model Groups copy-failure checks, specifically diagnose content patterns that trigger configurator merge failures. See Source Content Guidelines for the modeling rules that prevent these.
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
Sharing the report
The dialog has a Copy report button that puts a Markdown-formatted snapshot of the run on your clipboard: score, pass/warning/error counts, every check, and the full details list for non-pass checks. Paste this into a chat with the Alpha team or into a ticket when asking for help diagnosing a source RVT.
Severity Thresholds
| Check | Warning Threshold | Error Threshold |
|---|---|---|
| Document Warnings | 1-200 | > 200 |
| Group Integrity | Any issues | — |
| Reference Planes in Groups | — | Any occurrence |
| Schedules in Source | Any occurrence | — |
| Worksharing | Workshared document | — |
| 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 |