01 / 21

Nested Families
in Autodesk Revit

Learn how to embed one family inside another to build complex, flexible, and reusable BIM components from simple building blocks.

Autodesk Revit

What Is a Revit Family?

In Revit, a family is a reusable building component: a door, a window, a piece of furniture, a light fixture, or even a custom detail element. Every object you place in a Revit project is an instance of some family.

System Families
Built into Revit: walls, floors, roofs, ceilings. Cannot be saved as external files.
Loadable Families
Created in the Family Editor and saved as .rfa files: doors, windows, furniture, fixtures.
In-Place Families
One-off geometry created directly inside a project. Unique to that specific project file.

What Is a Nested Family?

A nested family is a family that has been loaded inside another family (the host family). The nested component becomes a child element within the host, bringing its own geometry, parameters, and behaviour along with it.

HOST FAMILY NESTED FAMILY A Geometry + Params NESTED FAMILY B Geometry + Params

Why Use Nested Families?

1
Modularity: Build complex objects from simple, reusable parts instead of modelling everything from scratch.
2
Flexibility: Swap nested components (e.g., different door handles) without recreating the host family.
3
Consistency: Update a nested family once and every host that uses it reflects the change.
4
Parametric control: Link host parameters to nested parameters so one slider adjusts multiple parts.

The Core Principle

Revit Project (.rvt) Host Family (.rfa) Nested Family A (.rfa) Nested Family B Sub-Nested Family

Shared vs Non-Shared Parameters

When a nested family has its own parameters, the host family can either expose or hide them from the project. This distinction is controlled by shared parameters.

Shared
The nested family's parameter is visible in schedules and tag-able at the project level. Data flows through to the project.
Non-Shared
The parameter stays internal to the host family. The project cannot see or schedule it directly.

Nested Families vs Modelling In-Place

Nested Family Modelled In Host
Reusability ✓ Reusable across hosts ✕ Tied to one host
Independent editing ✓ Own .rfa file ✕ Edit inside host only
Swappable ✓ Type-swap at instance level ✕ Must re-model
File size Moderate Smaller (no extra .rfa)
Complexity limit Good for complex parts Best for simple geometry

How to Nest a Family: Step by Step

1
Create the child family first. Open the Family Editor, build the geometry, add parameters, save as .rfa.
2
Open the host family in the Family Editor.
3
Load the child into the host: Insert tab → Load Family → select the child .rfa file.
4
Place the nested instance on a reference plane or at the origin of the host family.
5
Constrain and link parameters: Align/lock the nested family to reference planes, then associate its parameters with host parameters.
6
Test with Flex: Adjust host parameters and verify the nested family responds correctly.

Example 1: Door with a Nested Handle

HOST: Door Panel Family NESTED: Handle Family Width (host parameter)

Example 2: Light Fixture with Nested Lamp

HOST: Fixture Housing NESTED: Lamp Family Swap lamp type at instance level

Example 3: Desk Assembly with Multiple Nested Parts

HOST: Desk Family Desktop Surface (host geometry) NESTED: Leg Family (x4) NESTED: Drawer NESTED: Monitor Arm Host "Width" parameter drives leg spacing

Linking Parameters Between Levels

A powerful feature of nesting is parameter association: you connect a host family parameter to a nested family parameter so they stay synchronised.

Host Parameter "Overall Width" LINKED Nested Parameter "Drawer Width" In Properties Panel: Change "Overall Width" → Drawer auto-resizes

Controlling Visibility of Nested Parts

Sometimes you want a nested family to appear only in certain views or detail levels. Revit gives you two tools for this:

Visibility/Graphics
In the Family Editor, select the nested instance → Properties → set Visible parameter. You can link this to a Yes/No host parameter to toggle it on/off.
Detail Level
Set the nested instance's visibility per detail level: Coarse, Medium, or Fine. Show a simplified shape at Coarse, full detail at Fine.

Type Swapping: The Power of Nesting

One of the most powerful features of nested families is type swapping: loading multiple types of a nested family and letting users choose which one to display.

Door Family (Host) Handle Type A Lever Style Handle Type B Knob Style Handle Type C Pull Bar Users select handle type from a dropdown in the host's Type Properties

Common Mistakes to Avoid

✕ Over-Nesting
Nesting 4+ levels deep makes families slow to load and nearly impossible to debug. Keep it to 2-3 levels maximum.
✕ Forgetting Constraints
Placing a nested instance without locking it to reference planes means it won't move when the host resizes.
✕ Not Testing with Flex
Skipping the Flex test means you won't catch broken constraints until the family is already in a project.
✕ Shared Parameter Confusion
Making every parameter shared clutters schedules. Only share parameters that need to be scheduled or tagged.
✕ Mismatched Categories
A nested family in the wrong category won't appear in the correct schedule or filter. Always verify the Category setting.

Summary: Nested Families at a Glance

Concept Key Detail
What it is A family loaded inside another family
File format .rfa loaded into .rfa
Parameter linking Associate Family Parameter button
Type swapping Family Type parameter in host
Visibility control Yes/No parameter or Detail Level
Shared parameters Required for scheduling nested data
Recommended depth 2-3 nesting levels maximum

Question 1 of 5

What is a nested family in Autodesk Revit?

Question 2 of 5

Why would you use a shared parameter on a nested family?

Question 3 of 5

What is the primary benefit of type swapping in nested families?

Question 4 of 5

What is the recommended maximum nesting depth for Revit families?

Question 5 of 5

You place a nested handle family inside a door host, but when you change the door's width, the handle stays in the same position. What is the most likely cause?