Error · IFC Schema
How to fix Circular reference
in IFC files
Remove the circular relationship — an element cannot be its own ancestor. This is an export/interop artefact; re-export from a clean copy.
Check your IFC file — free
No account · No upload · Runs in your browser · 38 validation checks
What it means
The Circular reference check
Aggregate or containment relationship forms a cycle
The fix
How to fix Circular reference in your authoring tool
Concrete, tool-specific steps. The check itself is schema-agnostic and works for IFC2x3, IFC4, IFC4x1 and IFC4x3.
| Authoring tool | How to fix |
|---|---|
| Revit | Re-export with an up-to-date IFC exporter from a clean copy; if it persists, audit and purge the model. |
| ArchiCAD | Re-export with the latest IFC add-on; run a model check to find the offending relationship. |
| Tekla | Re-export from the native model — Tekla does not normally create reference cycles. |
| Allplan | Re-export from Allplan; recreate the affected objects if the cycle persists. |
How it works
Find and fix it in the browser
The whole flow runs client-side — your IFC file never leaves your machine.
01
Open your IFC file
Open IFC Viewer Online and drag & drop your IFC file. It is parsed locally in your browser via WebAssembly — nothing is uploaded.
02
Run the Health Score validation
Run validation. The "Circular reference" check (RULE_CIRCULAR_REFERENCE) flags every affected element and pinpoints it in the model tree.
03
Fix in Revit
Re-export with an up-to-date IFC exporter from a clean copy; if it persists, audit and purge the model.
04
Fix in ArchiCAD
Re-export with the latest IFC add-on; run a model check to find the offending relationship.
05
Fix in Tekla
Re-export from the native model — Tekla does not normally create reference cycles.
06
Fix in Allplan
Re-export from Allplan; recreate the affected objects if the cycle persists.
07
Re-validate
Re-export from your authoring tool and re-run validation to confirm the issue is resolved and your Health Score improved.
Related checks
Other IFC Schema checks →
Check your whole model, not just one rule.
Circular reference is 1 of 38 checks. Run the full IFC Health Score to see every issue and a single 0–100 number — free, no account, no upload.
Run the free Health Score →