01 / 21

Family
Parameters

Learn to create parameters and label dimensions inside Revit families to unlock true parametric behavior.

Autodesk Revit

What Is a Family Parameter?

A family parameter is a named variable inside a Revit family that controls geometry, visibility, or material assignments. When you change a parameter's value, the family updates automatically: that is parametric behavior.

Why Parameters Matter

★ Efficiency
One family can produce dozens of sizes: no need to duplicate files for each variation.
★ Consistency
Geometry relationships stay intact: changing width automatically adjusts dependent dimensions.
★ Scheduling
Parameters appear in schedules and tags, so data flows directly from the model to documentation.

Anatomy of a Parameter

Parameter Name e.g. "Width" Type of Parameter Length, Text, Yes/No... Group Under Dimensions, Identity... Instance or Type Per-element or per-type Formula (optional)
\( \frac{\text{Width}}{2} \)
Default Value e.g. 600 mm

The Core Rule: Label = Link

In Revit's Family Editor, a dimension is just a measurement until you label it with a parameter. Labeling creates a bi-directional link: change the parameter value and the geometry moves; move the geometry and the parameter updates.

Dimension 600 mm Label Parameter "Width" Bi-directional: change one, the other follows

Instance vs Type Parameters

Instance Parameter Type Parameter
Scope Unique per element Shared by all elements of same type
Editing Properties palette (per object) Edit Type dialog (changes all)
Common use Elevation, offset, flip Width, height, material
Schedule Each row can differ All rows share the value
Example Sill Height of a window Overall Width of a window

How to Create and Label

1
Open the Family Editor. Double-click an existing family, or go to File → New → Family and pick a template.
2
Draw or select geometry. Create the extrusion, sweep, or blend that needs to be parametric.
3
Add a dimension. Use the Annotate → Aligned Dimension tool to measure the distance or angle you want to control.
4
Select the dimension and click the Label drop-down in the Options Bar. Choose an existing parameter or click <Add parameter...> to create a new one.
5
Set name, type of parameter, group, and scope (Instance or Type). Click OK.
6
Flex the parameter. Open Family Types, change the value, and verify that the geometry responds correctly.

Example 1: Simple Box

"Width" "Height" Reference Planes Labeled Labeled

Example 2: Formulas

Formulas let one parameter drive another. For a table family where the leg inset is always \( \frac{1}{10} \) of the total width:

"Width" = 1200 mm "Leg_Inset"

Example 3: Yes/No Visibility

A Yes/No parameter can toggle the visibility of sub-components. For a desk family with an optional keyboard tray:

Desk Body Keyboard Tray "Has_Tray" = Yes Set to No → tray disappears

Labeling Dimensions: The How

Step 1 Select dimension Click on it Step 2 Options Bar Label drop-down Step 3 Pick or create parameter Result: dimension text changes to parameter name "600" → "Width = 600"

Locking vs Labeling

Locking Labeling
What it does Pins geometry to a reference Associates a dimension with a parameter
User control None: value is fixed Full: change via Properties or Type dialog
Appears in schedules? No Yes
Icon in editor Padlock symbol Parameter name on dimension
Best for Constraints that never change Values that users should adjust

Shared vs Family Parameters

Shared Parameter
Defined in an external .txt file. Can be used in schedules, tags, and across multiple families. Required when you need to tag a custom value.
Family Parameter
Lives only inside the family. Simpler to create but cannot be scheduled across families or used in tags. Best for internal geometry control.

Flexing: Testing Your Parameters

Flexing means changing parameter values in the Family Types dialog to verify the geometry responds correctly. It catches broken constraints before you load the family into a project.

1
Open Family Types (Create tab → Properties panel → Family Types).
2
Change one parameter at a time. Try minimum, maximum, and typical values.
3
Click Apply. Watch the preview or switch to a view to inspect geometry.
4
Look for errors: overlapping geometry, flipped extrusions, broken constraints, or elements flying off-screen.

Common Mistakes

✕ Unlabeled Dimensions
Adding dimensions but forgetting to label them. The geometry looks dimensioned but has no parametric control.
✕ Skipping Reference Planes
Dimensioning directly to geometry edges instead of reference planes. This creates unstable constraints that break during flexing.
✕ Wrong Scope
Making a parameter Type when it should be Instance (or vice versa). All instances then share a value that should vary.

Parameter Cheat Sheet

Concept Key Point Action
Parameter Named variable controlling geometry Create in Family Types
Label Links a dimension to a parameter Select dim → Options Bar → Label
Instance vs Type Per-element vs per-type scope Choose at creation time
Formula Auto-calculates from other params Enter in Formula column
Shared Parameter Schedulable and taggable Define in external .txt file
Flexing Tests parametric behavior Change values and Apply

Question 1 of 5

What must you do to a dimension in the Family Editor to make it parametric?

Question 2 of 5

A window family uses a parameter called "Sill Height" that can differ for every placed instance. What scope should this parameter have?

Question 3 of 5

In a table family, you want Leg_Inset to always equal \( \frac{\text{Width}}{10} \). Where do you enter this relationship?

Question 4 of 5

You need a custom parameter called "Fire Rating" to appear in a multi-category schedule. Which parameter type should you use?

Question 5 of 5

What is the purpose of "flexing" a family?