AUTODESK REVIT • VIEWS AND DOCUMENTATION

Dimensions — Create dimensions and align constraints with dimensions (intro)

Master the art of annotating and constraining your Revit models with precise, parametric dimensions.

Historical Context & Motivation

The act of dimensioning a drawing is as old as architectural drafting itself, stretching back to the hand-annotated plans of Renaissance master builders who inscribed measurements alongside their inked floor plans. For centuries, dimensions served a purely communicative function: a drafter would pick up a scale ruler, measure a distance on the drawing, and write the value by hand above a line with tick marks at each end. If the design changed, every related dimension had to be erased and redrawn—a tedious, error-prone process that consumed enormous amounts of studio time.

The arrival of computer-aided design in the 1980s automated the measurement step, but early CAD dimensions were still little more than text annotations placed on geometry; they did not 'know' what they measured. When Autodesk released Revit in 2000, it introduced a paradigm shift: dimensions became parametric objects that not only read distances from the model but could also drive those distances. This bidirectional relationship—annotation that constrains geometry—is the foundation of Building Information Modeling (BIM) documentation.

1400s
Renaissance Measured Drawings
Architects like Brunelleschi annotated plans with hand-written measurements and proportional notations, establishing the convention of dimension lines with witness lines extending to building elements.
1982
AutoCAD 1.0 Released
AutoCAD introduced associative dimensions that updated when geometry moved, but these were purely read-only annotations—they could not constrain element positions.
2000
Revit 1.0 Launches
Charles River Software released Revit with a parametric change engine where dimensions could lock elements in place, creating alignment constraints.
2004–2010
Autodesk Era & BIM Adoption
After Autodesk acquired Revit, successive versions refined dimension families, equality constraints, and label parameters—making dimensions a core documentation and design-control tool across the AEC industry.
2020s
AI-Assisted Dimensioning
Modern Revit releases explore automated dimensioning suggestions and cloud-based collaboration, but the fundamental principle—dimensions as bidirectional parametric annotations—remains unchanged.

The central question this lesson addresses is both practical and conceptual: how do you place accurate dimension annotations in Revit views, and how can those same dimensions constrain element positions so that your model remains internally consistent as the design evolves? Understanding this duality—dimensions as documentation and as constraints—is essential for any visual-arts student transitioning from freehand or static-CAD workflows into the parametric world of BIM.

Core Principles & Definitions

Before you click the Annotate tab, it is important to internalize a handful of foundational ideas that distinguish Revit dimensions from any dimension you may have drawn by hand or placed in a 2D CAD application. These principles govern how dimensions behave, what they reference, and why they are far more powerful—and occasionally more temperamental—than simple annotations.

1

Parametric Associativity

Every Revit dimension is parametrically linked to the model elements it references. Move a wall, and the dimension value updates instantly. Override a dimension value, and the wall moves to satisfy the new measurement.
2

Witness Lines & References

Witness lines (also called extension lines) connect the dimension line to references—specific geometric anchors on elements such as wall faces, center lines, or grid lines. The precision of your dimension depends on which reference you snap to.
3

Temporary vs. Permanent Dimensions

Temporary dimensions appear automatically when you select an element, showing its distance from nearby references. Permanent dimensions are placed deliberately using the Dimension tool and persist in the view for documentation.
4

Locking = Constraint

A small padlock icon appears near a dimension when it can be locked. Clicking it converts the dimension into an alignment constraint, preventing the measured distance from changing unless the lock is explicitly removed.
5

Equality Constraints

When a string of dimensions spans multiple segments, the EQ toggle forces all segments to remain equal—a powerful layout tool for evenly spaced columns, mullions, or gallery bays.
KEY TAKEAWAY
Think of a Revit dimension as a piece of elastic string tied between two objects in a physical model. The string always reports the current distance. If you lock it, the string becomes a rigid rod—now neither object can move closer or farther without breaking the constraint. This metaphor captures the dual role of dimensions: reporting distances when unlocked, and enforcing distances when locked.

Visual Explanation — Anatomy of a Revit Dimension

The diagram below dissects a typical permanent dimension string placed in a Revit floor plan view. Study it carefully: each labeled component maps directly to a property or behavior you will interact with in practice. Understanding the visual anatomy of a dimension will help you troubleshoot placement issues and interpret the Options Bar settings that appear whenever the Dimension tool is active.

The cyan reference points snap to wall center lines. Dashed violet witness lines extend from the references to the cyan dimension line. The amber lock icon converts the segment into a constraint. The emerald EQ toggle forces both segments to remain equal. The pink overall dimension reports the total span.

Notice how each element in the diagram serves a distinct purpose. The reference points determine what is being measured—whether you snap to a wall center line, a wall face, or a core boundary will yield different values for the same pair of walls. The dimension line is the horizontal (or vertical, or angular) annotation that carries the numeric value, while witness lines visually connect that annotation back to the geometry. As a visual-arts student accustomed to thinking in composition and hierarchy, consider the dimension string as a secondary layer of graphic information superimposed on the plan—its placement, spacing, and clarity directly affect the readability of your construction documents.

How Dimensions & Constraints Work Under the Hood

Revit's parametric engine operates on a system of geometric constraints that can be understood through straightforward relationships. When you place a dimension between two references, Revit internally records the algebraic distance between their positions. Though you do not write equations yourself, the software's constraint solver processes relationships that closely mirror the logic below.

DISTANCE BETWEEN REFERENCES
D = | x₂ − x₁ |
Where D is the displayed dimension value, x₁ is the position of the first reference, and x₂ is the position of the second reference, measured along the dimension line's axis.

When the dimension is unlocked, D is a reporting value—it simply reads the current positions and displays the result. The moment you lock the dimension, Revit converts it into a hard constraint:

LOCKED DIMENSION CONSTRAINT
| x₂ − x₁ | = D_locked
The solver now prevents any operation that would change the absolute distance between x₁ and x₂ to a value other than D_locked. Attempting to move Wall A closer to Wall B will trigger a constraint conflict warning.
EQUALITY CONSTRAINT (EQ)
D₁ = D₂ = D₃ = … = Dₙ
When EQ is toggled on a dimension string with n segments, the solver forces every segment to maintain the same value. If the overall span is L, each segment becomes L ÷ n.

To make these relationships tangible: imagine five evenly spaced gallery columns across a 20-meter façade. You place a dimension string across all six reference points (one at each column face) and toggle EQ. Revit calculates 20,000 mm ÷ 5 segments = 4,000 mm per bay. If you later stretch the façade to 25 meters, every bay automatically updates to 5,000 mm—no manual re-dimensioning required.

⚠️ Constraint Conflicts
Over-constraining your model is the most common pitfall for beginners. If you lock dimensions that logically contradict each other—say, locking each segment and the overall dimension to incompatible values—Revit will display an error and refuse the operation. The principle is similar to a system of linear equations with no solution: the solver cannot satisfy all constraints simultaneously.

Types of Dimensions in Revit

Revit provides several dimension types to suit the range of measurements architects and designers encounter. Choosing the right type is analogous to choosing the right brush for a particular stroke—each one excels in a specific context. The diagram below categorizes the primary dimension types and the workflow context in which each is most useful.

Five primary dimension types in Revit: Aligned dimensions measure along angled elements, Linear dimensions project horizontally or vertically, Angular dimensions measure angles, Radial dimensions measure radius/diameter, and Arc Length dimensions measure along curved paths.
Comparison of Revit's primary dimension types and their constraint capabilities.
Dimension TypeBest ForCan Lock / Constrain?
AlignedWalls, structural members, or references at any angleYes — locks true distance along the element
LinearHorizontal/vertical clearances, column spacing in orthogonal gridsYes — locks horizontal or vertical component only
AngularRoof pitches, angled walls, curtain wall mullion splaysYes — locks the angle between two references
RadialCurved walls, arched openings, circular columnsYes — constrains the radius value
Arc LengthCurved façade panels, arc spans in plan/section viewsNo — reporting only in most contexts

Worked Example — Dimensioning a Gallery Wall Layout

Imagine you are designing a small gallery space with three parallel partition walls that define two display bays. Each bay must be exactly 4,000 mm wide, measured center-to-center. The following walkthrough demonstrates how to place dimensions, verify the measurements, lock them as constraints, and apply the equality toggle to guarantee uniform bay widths as the design evolves.

Placing & Constraining Gallery Bay Dimensions
1
Step 1 — Activate the Dimension ToolNavigate to the Annotate tab in the Ribbon and select Aligned from the Dimension panel. In the Options Bar, confirm that the reference preference is set to Wall centerlines. This ensures all witness lines snap to the structural center of each wall rather than to a face finish.
2
Step 2 — Click References SequentiallyClick the center line of Wall A, then Wall B, then Wall C. After the third click, move your cursor upward to position the dimension line above the plan geometry and click to place it. Revit creates a dimension string with two segments.
Dimension string placed with segments reading 4,000 and 4,200 mm.
3
Step 3 — Edit Values to Correct LayoutClick the 4,200 value directly on the dimension string. A text field activates. Type 4000 and press Enter. Revit moves Wall C so that the center-to-center distance becomes exactly 4,000 mm.
Both segments now read 4,000 mm. Wall C repositioned automatically.
4
Step 4 — Lock Dimensions to Create ConstraintsSelect the dimension string and hover over the first segment. A small padlock icon appears. Click it to lock segment A–B at 4,000 mm. Repeat for segment B–C. Both locks turn solid, indicating active constraints. Attempting to drag any wall will now produce a constraint error.
Two locked constraints: D(A–B) = 4,000 mm, D(B–C) = 4,000 mm.
5
Step 5 — Apply the EQ ToggleWith the dimension string selected, locate the EQ symbol displayed between the segments. Click it once—it changes from a slashed EQ to a solid EQ. Now, even if you later insert a fourth wall and extend the string, Revit will redistribute all bays equally.
Equality constraint active. All segments locked to equal widths.
💡 Pro Tip: Converting Temporary to Permanent
If you select a wall and see a temporary dimension you want to keep, look for the small blue dimension symbol (resembling a ruler icon) near the temporary dimension line. Clicking it converts the temporary dimension into a permanent one—useful when you want quick documentation without invoking the Dimension tool.

Strengths, Limitations & Best Practices

Revit dimensions and constraints are powerful, but understanding their limitations is just as important as understanding their capabilities. The following comparison highlights scenarios where dimension-based constraints excel and where alternative strategies may be more appropriate.

Strengths vs. Limitations of Revit dimension-based constraints.
StrengthsLimitations
Bidirectional: editing a dimension value moves the geometry instantly, keeping documentation and model in sync.Over-constraining is easy—locking redundant dimensions creates conflicts that can be difficult for beginners to debug.
EQ toggle provides a one-click equal-spacing solution, ideal for rhythmic layouts in galleries, façades, and structural grids.Cannot express complex relationships (e.g., 'Bay B is 1.5 × Bay A')—only equality and fixed values are supported by dimension locks.
View-specific styling (font, tick marks, units) is controlled through dimension types, allowing consistent graphic standards across a project.Dimension appearance is tied to the view scale; changing scales may require repositioning dimension lines for clarity.
Locking dimensions documents design intent—other team members can see which distances are fixed by reading the plan.Locked dimensions are invisible in views where the dimension annotation is not placed, potentially confusing collaborators.
KEY TAKEAWAY
Think of dimension constraints like the fixed joints in a physical scale model: a few well-placed rigid connections keep the structure true, but rigidly fixing every joint makes the model impossible to adjust. The best practice is to lock only the dimensions that embody non-negotiable design intent—critical clearances, code-mandated distances, or proportional relationships that define the project's spatial character—and leave the rest flexible for iterative refinement.
  • Name your dimension types clearly (e.g., 'Plan – Linear – 2.5 mm Text') so that graphic standards are self-documenting.
  • Place overall dimensions first, then break down into intermediate and detail dimensions. This layered approach mirrors architectural convention.
  • Use alignment lines (grids) as primary references whenever possible—grid-to-grid dimensions are less likely to be disrupted when walls are edited.
  • Audit locks periodically using the Review Warnings tool to identify orphaned or conflicting constraints before they cascade into model errors.

Connection to Advanced Parametric Techniques

The dimension-and-lock workflow introduced in this lesson is, in fact, the entry point to a much larger parametric universe within Revit and its ecosystem. Once you are comfortable constraining model elements with dimensions, you can progress to labeled parameters, formulas, and even computational design—each layer building on the same fundamental principle: geometry driven by numeric relationships.

How introductory dimension skills scale into advanced parametric workflows.
This Lesson (Introductory)Advanced Parametric Techniques
Lock a dimension to fix a distance at a single value.Assign a labeled parameter to the dimension, making it editable via a type or instance schedule.
Toggle EQ to force equal spacing.Write formulas (e.g., Bay Width = Overall Length / Number of Bays) for dynamic proportional control.
Manually place dimensions in plan views.Use Dynamo scripts to auto-generate and place dimension strings across hundreds of elements.
Constrain individual walls in a project.Build reusable Family definitions where internal dimensions are parameterized, creating intelligent components.

For visual-arts students, the creative potential of parametric constraints is especially exciting. Imagine a responsive gallery installation where the spacing between partition walls is governed by a single slider-controlled parameter: drag the slider to adjust density, and every wall repositions while the dimension annotations update in real time. This is the exact workflow professional firms use when presenting design options to clients—roots that begin with the simple act of placing and locking a dimension.

Practice Problems

PROBLEM 1CONCEPTUAL
Explain the difference between a temporary dimension and a permanent dimension in Revit. Why might a designer choose to convert a temporary dimension into a permanent one rather than placing a new dimension from the Annotate tab?
PROBLEM 2BASIC CALCULATION
You place a dimension string across four walls (A, B, C, D), yielding three segments. The overall dimension reads 12,000 mm. You toggle the EQ constraint. What value will each segment display?
PROBLEM 3INTERMEDIATE
A designer has locked segment A–B at 3,500 mm and segment B–C at 3,500 mm. She then attempts to lock the overall dimension A–C at 8,000 mm. Predict what happens and explain why.
PROBLEM 4APPLIED
You are documenting a gallery with a curved back wall (radius 8,000 mm). The curator requires that five equally spaced display niches be recessed into the curve. Describe which dimension type(s) you would use to (a) annotate the wall's curvature, (b) dimension the spacing between niches, and (c) constrain the niche positions to remain equidistant.
PROBLEM 5CRITICAL THINKING
Consider a scenario where a large collaborative project has accumulated dozens of locked dimension constraints placed by different team members over several months. Discuss the risks this poses to design flexibility and propose a strategy for managing constraints at the project level. How does the concept of 'design intent' help you decide which locks to keep and which to remove?

Lesson Summary

Revit dimensions are far more than annotations—they are parametric objects that both report and drive model geometry. A dimension string consists of reference points (snapped to wall centers, faces, or grids), witness lines connecting those references to the dimension line, and numeric values that update automatically as elements move. Five primary types— Aligned, Linear, Angular, Radial, and Arc Length—cover the full range of geometric measurements encountered in architectural documentation.

The transformative feature is the lock icon, which converts a reporting dimension into an alignment constraint—a rigid rule that the parametric engine enforces. The EQ toggle extends this to multi-segment strings, guaranteeing equal spacing. Best practice calls for locking only dimensions that embody design intent and leaving others flexible to avoid over-constraining the model. These introductory skills form the foundation for advanced parametric techniques—labeled parameters, formulas, and computational design—that will appear in later lessons.

Varsity Tutors • Autodesk Revit • Dimensions — Create dimensions and align constraints with dimensions (intro)