Getting started
Open the app. The workspace has three columns:
- Left — the family catalog (click one to open it) and a
Newbutton (creates a blank family instantly with the Metric Generic Model template). - Middle — the 3D viewport, showing your family live.
- Right — the editor panel: a toolbar plus four tabs,
Parameters,Types,Materials(the family's materials and subcategories), andGenerators(where the geometry lives — its list is headed Elements).
Build a door panel, step by step
This walks the whole loop once. Every control named below is a real button in the panel.
- Start a new family. Click the file icon in the toolbar (tooltip
New graph). In the New Graph dialog type a Name, pick a Template (Metric Generic Modelis fine), thenCreate. Parameters and Generators start empty. - Add the driving parameters. On the
Parameterstab click+and chooseLength. A row appears — click its key and rename itWidth, then type900in the value cell next to it. That value belongs to the family type named in the dropdown at the top of the tab (a new family starts with one calledDefault) — in Revit a value always lives on a type, never on the parameter. Repeat forHeight(2100) andThickness(45). Leave the row's⚙→Instancebox clear: these are type parameters, which is what lets the derived parameter in the next step read them (see Parameters & coordinates). - Add a derived parameter. The panel sits centred, so we need half its height. Add another
Length, rename itHalfHeight, and in its⚙popover typeHeight / 2into Formula. Its value cell now shows the formula, greyed out — Revit computes it, so no type stores a value for it. (Math lives in formulas, not in geometry fields — and a formula is written in Revit's formula language, not JavaScript. See Parameters & coordinates.) - Draw the profile. Switch to the
Generatorstab. Click+, and underSHAPEpickRectangle. A rectangle element is added. - Make it follow the parameters. Click the rectangle row to select it — its fields expand. Each coordinate field has two buttons,
V(a fixed value) andP(follow a parameter). ForwidthclickPand chooseWidth; forheightchooseHeight; for the center'sYchooseHalfHeight. Leave centerXonV=0. - Give it depth. Click
+again and underFORMpickExtrusion. Select it; in theprofilecheckbox list tick yourrectangle, and setdepthtoP→Thickness. You now have a 3D door panel. - Tune it live. Back on
Parameters, changeWidthto1000— the panel widens in the viewport instantly. That is the whole parametric loop, before Revit. - Add size variants. On the
Typestab add more named types like900 × 2100, each with its own set of values — the user picks one when placing the family. Each card's radio button makes that type the one the editor (and the viewport) shows. - Save / export. The disk icon (tooltip
Save JSON) downloads the family as a.jsonfile. To produce the real.rfa, open the family in the Molding Revit plugin and press the ▶ button (tooltipGenerate .rfa (requires Revit)).
In the browser you design and preview. The actual
.rfais produced by the Molding Revit add-in — this same editor inside a Revit panel, where the Generate button is enabled.
Grab it from the Revit Plugin page. New to the V / P toggle? It is the core idea — read Parameters & coordinates next.
📖 3 min read