A revit adaptive family, or adaptive component, is a family with several insertion points. When you place it, you click each point in turn and the shape stretches to fit them. That lets a single panel family cover a curved facade where no two cells are alike.
This article works through one example in Revit 2027: build a 4-point panel, divide a 24 × 15 m curved facade into a grid, and populate it with 60 panels using Repeat. Then it measures the warp of every panel, colours the panels and schedules them for the fabricator. For structured architectural modelling, see the Revit Architecture course.
How an adaptive family differs from a normal family
| Normal family | Adaptive family | |
|---|---|---|
| Insertion points | One | Several, numbered 1, 2, 3… |
| Shape driven by | Dimension parameters | Where you click the points when placing |
| Template | By category | Metric Generic Model Adaptive.rft |
| Placed on divided-surface nodes, used with Repeat | No | Yes |
| Typical use | Doors, columns, equipment | Cladding panels, fins, glazing frames, irregular roofs |
According to Autodesk: Adaptive Components, adaptive points are reference points made adaptive, and they can only be created in the Generic Model Adaptive template. You can assign a category to an adaptive component, such as Curtain Panels or Generic Models.
Building a 4-point adaptive panel
- Go to Home › Families › New and choose Metric Generic Model Adaptive.rft.
- In a 3D view, pick Point Element on the Draw panel and place 4 points on Ref. Level.
- Select all 4 points and click Make Adaptive on the Adaptive Component panel. They are numbered 1–4 in the order placed.
- Choose Reference, the Line tool on the Draw panel, and turn on 3D Snapping on the Positioning panel.
- Click the centres of points 1, 2, 3, 4 and back to point 1. The snap marker must sit exactly on each point.
- Press
Esc. HoldCtrl, select all 4 lines, click Create Form and choose the surface option at the bottom of the screen for a thin panel.
- In the family's Properties palette, tick Shared. This decides whether panels can be counted in the project; see the scheduling section below.
- Save the family, for example IIC_Tam_4_diem.rfa.
Skipping step 4 is the most common mistake: the lines attach to the work plane instead of the points, so the placed panel keeps its original size.
Fix the family and reload it with Overwrite the existing version; placed panels stretch to their points. You can also place panels by hand in a project with 4 clicks each: every panel takes its own shape.
Facade design with adaptive components: a 4-step workflow
Placing panels by hand only suits a few dozen. A real facade has hundreds or thousands, so the standard workflow divides the mass surface into a grid and lets Revit populate it (Autodesk: Geometry Division and Component Repetition).
| Step | Task | Where |
|---|---|---|
| 1 | Model the facade as a mass | Metric Mass.rft family, or an In-Place Mass |
| 2 | Divide the surface into a U, V grid | Divide Surface |
| 3 | Place one panel on 4 grid nodes, then Repeat | In the mass family |
| 4 | Load the mass into the project and schedule panels | Load into Project |
The example facade is 24 m × 15 m, undulating horizontally with an amplitude of 1.2 m at the base and top and 2.4 m in the middle. It curves in both directions, the kind of facade often found on lobbies and retail podiums. Building masses with Create Form is covered in massing in Revit.
Divide Surface: turning the facade into a panel grid
- In the mass family, select the face to divide. If you cannot select faces, turn on Select Elements by Face at the right end of the status bar.
- Click Modify › Form › Divide › Divide Surface. Revit lays a U, V grid over the face.
- In Properties, under U Grid and V Grid, set Layout to Fixed Number or Fixed Distance and enter the count or spacing.
The example uses 6 divisions vertically and 10 horizontally. Revit reports a grid spacing of 2,500 mm vertically and 2,613.8 mm horizontally, measured along the curved surface, and a divided surface area of 372.229 m².
Fixed Number keeps the count when the surface changes size. Fixed Distance keeps the cell size to the manufacturer's panel module, pushing the remainder to the edges.
Placing a panel on grid nodes and populating with Repeat
Before placing a panel, make the grid nodes visible:
- Select the divided surface and click the small arrow at the corner of the Surface Representation panel.
- On the Surface tab, tick Nodes and click OK. Nodes appear as dots.
Skip this and your clicks attach the adaptive points to edges or planes instead of nodes. The panel still appears, but Repeat never shows on the ribbon. Checked through the API, three points were hosted as PointOnEdge and one as PointOnPlane. With Nodes ticked, all four attach to nodes.
- Go to Create › Component, pick the panel family and click 4 nodes in order 1 → 2 → 3 → 4, anticlockwise from the bottom-left.
- Select the panel and click Repeat on the Modify panel of the Modify › Generic Models tab (Autodesk: Repeat Adaptive Components).
Revit fills every cell and groups the panels into a Repeater: 10 × 6 = 60 panels. Change the divisions and the panel count follows: at 8 × 5 the Repeater drops to 40 panels on its own. To break it into individual panels, select the Repeater and click Remove Repeater.
Panel warp: the fabrication problem of curved facades
Four points on a doubly curved surface are usually not coplanar. A 4-point panel then warps: the fourth point sits off the plane through the other three. Flat glass and flat aluminium panels cannot take large warp, so you need to know each panel's warp before choosing materials.
Measured on the example facade, the distance from point 4 to the plane through points 1, 2 and 3 of each panel:
| Grid | Panels | Maximum warp | Median | Panels warped over 30 mm |
|---|---|---|---|---|
| 10 × 6 (cells ≈ 2.6 × 2.5 m) | 60 | 360 mm | 144 mm | 48 |
| 20 × 12 (cells ≈ 1.3 × 1.25 m) | 240 | 103 mm | 31 mm | 120 |
Only 12 of 60 panels are near-flat (about 2 mm), the two columns sitting exactly where the curvature reverses. Halving the cell size in each direction cuts the maximum warp about 3.5 times but quadruples the panel count. One more number for the fabricator: the 60 panels have 56 different sets of edge lengths, almost one drawing per panel.
To see problem panels at a glance, write each panel's warp class into its Comments parameter and colour them with View Filters. Three filters match three classes: flat under 10 mm, warp 10–200 mm, warp over 200 mm.
Three ways to deal with warped panels:
- Triangulate: use a 3-point adaptive panel. Three points always define a plane, so the panel is always flat, at the cost of twice the panels and more joints.
- Divide more finely where curvature is strong, keeping large cells where the surface is flatter.
- Rationalise the form to a singly curved surface, such as a cylinder or ruled surface, where 4-point panels can be flat.
Writing warp classes into Comments in bulk is a job for Dynamo or the API; see Dynamo.
Bringing the facade into the project and scheduling panels
- In the mass family, click Load into Project and place the mass in a plan.
- Revit switches to Show Mass Form and Floors so the mass is visible. The mass is a surface with no solid, so Revit warns "Mass contains no solid geometry. Mass Floors, volume, and surface area, won't be computed". This is normal for a facade.
- Create a Generic Models schedule with Family, Comments and Count, grouped by Comments, with Itemize every instance turned off.
Because the panel family was marked Shared when it was built, the 60 panels appear in the project as 60 separate Generic Models elements that can be counted and scheduled.
If the group names contain Vietnamese diacritics, check the schedule's text font. The Revit 2027 Metric template has a text type using Trebuchet MS, which shows boxes instead of accented letters; the fix is in Revit shared parameters.
Common problems
| Symptom | Cause | Fix |
|---|---|---|
| Panel does not stretch to the clicked points | Lines in the family are not attached to the adaptive points | Redraw the lines with 3D Snapping on and reload the family |
| No Make Adaptive button | The family was not started from Generic Model Adaptive | Recreate it from Metric Generic Model Adaptive.rft |
| No Repeat button | Panel points attached to edges or planes, not nodes | Tick Nodes in Surface Representation and place the panel again |
| Cannot select a face for Divide Surface | Face selection is off | Turn on Select Elements by Face |
| Schedule shows no panels | The panel family is not Shared | Tick Shared, reload into the mass and then into the project |
| Warning Mass contains no solid geometry | The mass is a surface only | Normal for a facade; Mass Floors are not computed |
| Flat glass panels will not fit | 4-point panels warp on a doubly curved surface | Measure warp, triangulate or divide more finely |
FAQ
Can a revit adaptive family replace a curtain wall?
Yes, when the grid is irregular or the surface curves in both directions. For a flat facade with a regular grid, Curtain Wall or Curtain System is faster and comes with mullions and panels.
How is an adaptive component different from Curtain Panel Pattern Based?
Curtain Panel Pattern Based is a panel family tied to a preset grid pattern (rectangle, triangle, hexagon…) applied to a divided surface through the Pattern tab. An adaptive component is freer: it sits on any nodes, with any number of points, and also works away from divided surfaces, for fins, frames and tubes along curves.
Can each panel have a different opening?
Yes. Add an instance parameter to the panel family, such as an opening ratio, and set it per panel with Dynamo based on distance to an attractor point or sun direction. Variable shading facades are usually built this way.
If the facade changes, do I have to place the panels again?
No. Panels sit on grid nodes and nodes sit on the surface. Change the form or the divisions and the Repeater repopulates the panels on the new grid.
In short, a revit adaptive family lets one panel family cover a curved facade: divide the surface with Divide Surface, place a panel on nodes, Repeat, then measure warp and schedule the panels before handing over to fabrication.