COBie 2.4 · Asset guide

Assembly

Expresses parent-child composition between Type records or between Component records.

Worksheet09Detailed design onward
The question the Assembly worksheet answers

Which items are physically or logically part of another item?

Represent composition explicitly

Assembly records describe a parent item that owns, encloses, or is composed of child items. Annex A's IFC mapping allows ParentName and ChildNames to resolve to either product instances or type objects, represented in the spreadsheet as Component or Type context selected by SheetName.

The spreadsheet schema uses the plural ChildNames heading but does not define it as a foreign key or include it in the compound key, while the IFC mapping resolves a child to one product or type name. The issued workbook and validator should therefore determine whether an implementation accepts a delimited child list or normalizes relationships into separate rows.

AssemblyType adds the nature of the composition, such as fixed, optional, included, excluded, layered, patched, or mixed. These distinctions can describe a manufactured set, a layered construction, or another contract-defined composition that cannot be communicated by a flat asset list alone.

Know when Assembly adds value

Assembly is different from System and Connection. A System groups assets by shared function, while a Connection describes a logical upstream-to-downstream relationship. Assembly says that one managed item is made from or contains others. The project should use the worksheet only when that composition is required and useful to the receiver.

The COBie 2.4 publication says Assembly is not required for the U.S. facility and asset-management exchanges covered by its design and handover QC testing. It is tested when supplied and may still be required by a contract or another implementation. When used, every parent and child must exist, repeated relationships should be removed, and circular chains must be prevented.

Reviewing Revit composition before export

Revit nested families, groups, assemblies, curtain systems, and host relationships can provide candidate composition evidence, but they do not automatically represent the hierarchy an operator wants. Authoring convenience and facility-management structure are different concerns, so source rules should be agreed rather than inferred from every nesting relationship.

BIMRelay keeps generated Assembly references tied to the source workbook rows and can validate that each parent and child exists after regeneration. Model context helps reviewers decide which relationships are meaningful, while project-controlled rows can be retained even when they are not directly derived from Revit geometry.

Key relationships

References either Type or Component in each row

Connects a valid parent to a valid child in each row

Practical quality checks

  • Avoid circular relationships
  • Use valid worksheet names
  • Confirm parent and child both exist

Assembly worksheet FAQ

What is the COBie Assembly worksheet?
Assembly records parent-child composition between COBie Types or between COBie Components. It describes what an item contains or is made from.
How is Assembly different from System?
Assembly describes composition or containment. System groups Components that work together to provide a function, even when no item contains another.
Is the Assembly worksheet always required?
No. The COBie 2.4 publication excludes Assembly from required U.S. design and handover QC coverage and tests it only when supplied. A contract or another implementation may still require it.
Can BIMRelay validate Assembly relationships?
BIMRelay can keep Assembly rows linked to the relevant Type or Component records and check that parent and child references remain valid through workbook regeneration.
Editorial scope

This is an independent practical summary, not a reproduction of the COBie specification. Refer to the official standard for normative definitions and field requirements.

Reviewed against the official NIBS COBie 2.4 publication and Annex A worksheet schemas.

Where the official documents, contract-issued workbook, and project validator differ, follow the contract requirements and accepted validation process.

Open the official COBie 2.4 publicationOpen the official COBie 2.4 Annex A worksheet schemas