Node reference#

The + menu on the Generators tab is organised into groups. Click +, pick a group, then pick a node type to add it to the Generators list. Click any node row to expand its argument fields.

Segments — open curves#

Segment nodes produce open curves. Use them in two ways:

• As segments inside a loop node to build a freeform closed profile.
• As the path of a sweep or sweptBlend form.

line#

A straight line between two points.

arc (3-point)#

A circular arc that passes through three points: start → mid → end.

ellipseArc#

A partial ellipse defined by a centre, two semi-axes, and a start/end angle.

spline#

A smooth interpolated curve through an ordered list of points.

Use the + point and × buttons in the expanded row to add and remove points.

Shapes — closed profiles#

Shape nodes produce closed loops. They are the most common input to form profile fields.

rectangle#

circle#

ellipse#

Limitation: Revit cannot dimension an ellipse's radii, so an ellipse profile does not flex when its radii reference a parameter. Use rectangle, circle, or loop when you need a flexible profile size.

polygon#

A regular polygon with equal sides. radius is the circumradius (centre to vertex).

slot#

A stadium — two parallel lines capped with semicircles (also called a pill or obround).

loop#

A freeform closed profile assembled from ordered segment nodes.

The last point of each segment must connect to the first point of the next, forming a closed chain.

Forms — 3D solids and voids#

Forms build 3D geometry from profiles. Every form accepts these common settings:

• Solid / Void (isSolid) — switch in the node row; a void cuts overlapping solids.
• Material — pick a material node from the graph. Material nodes are processed in a pre-pass and can appear anywhere in the list.
• Subcategory — assigns the form to a Revit subcategory (for graphics overrides). In JSON: "meta": { "subcategory": "Panel" }.
• Visibility — per-detail-level on/off: Coarse / Medium / Fine. In JSON: "meta": { "visibility": { "coarse": false, "medium": true, "fine": true } }.

For a full walkthrough of each form type, see Form types.

extrusion#

Sweeps a profile along the Z axis.

blend#

Lofts between a bottom profile and a top profile.

revolution#

Spins a profile around an axis.

sweep#

Pushes a constant profile along a path.

sweptBlend#

Follows a path and morphs between two profiles.

opening#

Cuts a hole through a specific host form.

Limitation: opening accepts a single outer loop. For perforated cuts (holes with holes), use a void extrusion with isSolid: false instead.

Curves — visible line elements#

Curve nodes produce visible lines in the Revit family, not geometry. They use the same segment nodes as profiles.

modelCurve#

A 3D model line visible in all views.

Assign a Line Style (in the node settings panel) to control appearance. In JSON: "meta": { "lineStyle": "<style name>" }.

symbolicCurve#

A 2D symbolic line visible only in plan and section views.

Line style in JSON: "meta": { "lineStyle": "<style name>" }.

Arrays#

Array nodes repeat a source node. Count and spacing are baked at generation — they cannot flex when a parameter changes in Revit. For a flexible count, model repeats explicitly.

linearArray#

Copies a node in a straight line.

radialArray#

Copies a node in a circle.

Arrays and transforms — ordering requirement#

Arrays and transforms operate on already-created Revit geometry. Their source node must appear earlier in the nodes array — if the source hasn't been created yet when the array or transform is processed, it is silently skipped. The validator does not catch this; it is a runtime ordering constraint.

Exceptions (no ordering required): material and adaptivePoint nodes are processed in separate pre-passes before all other geometry, so they can appear anywhere in the list.

Shapes and curves (rectangle, circle, loop, arc, etc.) referenced by forms can also appear in any order — forms resolve them by key from the JSON dictionary before creating geometry.

Convention: declare shapes/forms first, then arrays and transforms that reference them.

Transforms#

Transform nodes reposition geometry. Behaviour differs by type:

• copy and mirror — the source is preserved and an additional copy is produced.
• move, rotate, and scale — the source is replaced in place (Revit moves/rotates/scales the element; no duplicate is created).

mirror#

move#

rotate#

copy#

scale#

Datum#

referencePlane#

An explicit named reference plane. Molding auto-generates reference planes for every parametric coordinate — only add one manually when it must be visible and named in the Family Editor.

Material#

material#

Declares a Revit material. Material nodes are processed in a separate pre-pass before all form geometry, so their position in the nodes list does not matter — they can appear before or after the forms that reference them.

To apply: in the form row, open the node settings and pick the material from the Material dropdown. In JSON, use the applyMaterial modifier on the form node.

Text#

modelText#

3D extruded text. Has no 3D viewport preview — it appears only in the generated .rfa.

Set Label (meta.label) to give the element a readable name in Revit's element tree.

Annotations — 2D, view-only#

Annotation nodes create view-specific 2D elements. They appear only in plan/section views inside Revit and have no 3D viewport preview.

textNote#

filledRegion#

A filled hatch region.

detailCurve#

A 2D detail line.

Assign a Line Style in the node settings panel to control appearance. In JSON: "meta": { "lineStyle": "<style name>" }.

control#

Flip/rotate arrows added to the family for use in the project.

image#

A raster image placed in the first 2D view.

MEP#

connector#

An MEP connector attached to a form face. The family must be in an MEP category (Electrical Fixtures, Mechanical Equipment, Plumbing Fixtures…).

The connector is placed on the first planar face of the host form.

Adaptive#

Adaptive nodes require an adaptive family template (e.g. metric-generic-model-adaptive). They make the family snap to points the user clicks when placing it in a Revit model.

adaptivePoint#

A placement click point. Points are activated in the order they appear in the Generators list (first node = first click).

adaptiveLoftForm#

A lofted solid or surface through profiles of adaptive points.

One profile → a cap surface. Two or more profiles → a loft.

curveByPoints#

A reference curve through adaptive points.

Family#

nestedFamily#

Places a nested .rfa instance inside this family.

To wire nested parameters, use the Parameter Links editor that appears in the expanded node row.