01 / 21
K

Text & Keynotes
in Autodesk Revit

Master the art of adding text annotations, keynotes, and detail components to communicate design intent clearly in your Revit projects.

Autodesk Revit

What Are Annotations?

In Revit, annotations are 2D elements that exist only in a specific view. They do not appear in the 3D model itself. Instead, they add information on top of the model to communicate design details to builders, clients, and reviewers.

View-Specific
Annotations belong to one view: they appear only on the sheet or plan where you place them.
Scale-Dependent
Text and symbols automatically resize when you change the view scale, keeping readability consistent.
Non-Model
They have no physical geometry: walls, floors, and roofs are model elements; text and keynotes are not.

The Big Three Annotation Tools

Revit offers three primary annotation tools for documenting your designs. Each serves a distinct purpose in the construction document workflow.

Text Notes
Free-form text you type directly onto a view: descriptions, instructions, and custom labels.
Keynotes
Standardized tags linked to a keynote table: they reference material specs and ensure consistency across sheets.
Detail Components
Pre-drawn 2D families (insulation, blocking, flashing) that enrich section and detail views with graphic clarity.

Why Annotations Matter

Without Annotations Unclear intent With Annotations Window: Type A K: 09.21.01 Ext. Wall Assy. Clear documentation

Text Notes: The Basics

Text Notes are the simplest annotation tool. You place free-form text anywhere in a view. Revit offers two placement modes and rich formatting options.

Placement Modes
One-click: click to place, then type. Two-click: drag a text box boundary first, then type: text wraps automatically.
Leader Lines
Add one or two leaders that point from the text to the element being described. Choose straight, arc, or no leader.

Text Note Properties

PROVIDE \( \frac{1}{2}^{\prime\prime} \) GYP. BD.
ON METAL STUDS @ \( 16^{\prime\prime} \) O.C.
Font & Size Text Wrapping Leader Line Arrowhead Width (Type Parameter) Key Type Properties:
Font: Arial Narrow | Size: \( \frac{3}{32}^{\prime\prime} \) | Bold/Italic | Background: Opaque/Transparent

What Are Keynotes?

Keynotes are coded annotations that reference entries in an external keynote table (a .txt file). Instead of typing "Gypsum wallboard, Type X, \( \frac{5}{8} \) inch," you place a tag that displays a short code like 09.21.16.A. A legend on the sheet links codes to full descriptions.

09.21.16.A RevitKeynotes.txt 09.21.16.A
Gypsum Board, Type X, \( \frac{5}{8}^{\prime\prime} \)
04.21.13.B Brick Veneer, Standard 07.62.00.C Sheet Metal Flashing Keynote Legend (on Sheet) 09.21.16.A
Gypsum Board, Type X, \( \frac{5}{8}^{\prime\prime} \)
04.21.13.B Brick Veneer, Standard

Three Types of Keynotes

Element Keynote
Tags an entire element (wall, floor, roof). The keynote value comes from the element's type properties. Click the element to place.
Material Keynote
Tags a specific material within an element. Click the face of a material layer in a section view to place.
User Keynote
A manually chosen keynote from the table. You pick any code you want, independent of the element. Great for notes like "Sealant at joint."

Text vs. Keynotes

Text Notes Keynotes
Content Source Manually typed External .txt table
Consistency Varies by user Standardized codes
Updates Edit each note individually Edit table once: all update
Legend Not applicable Auto-generated legend
Best For Custom instructions, unique notes Material specs, standard details

Detail Components: Adding Graphic Depth

Detail components are pre-drawn 2D families that you place in detail and section views. They represent items too small or too specific for the 3D model: insulation batts, blocking, anchors, sealant beads, and more.

Section View (Before) Section View (After)

How to Add Text Notes

1
Open a view where you want the text (floor plan, section, detail, or drafting view).
2
Annotate tab → Text panel → Text (or shortcut TX). Choose a text type from the Type Selector in the Properties panel.
3
Set leader options on the Options Bar: No Leader, One Leader, or Two Leaders. Choose straight or arc.
4
Click to place (one-click mode) or drag a box (two-click mode) in the view canvas.
5
Type your text. Use the mini-toolbar for bold, italic, underline, and list formatting. Press Esc or click outside to finish.

How to Place Keynotes

1
Set the keynote file: Annotate tab → Keynoting Settings → Browse to your .txt keynote file (usually office-standard or CSI format).
2
Choose keynote type: Annotate → Tag panel → Keynote dropdown → Element, Material, or User Keynote.
3
Click the element or material in the view. For User Keynotes, a dialog lets you pick from the keynote table manually.
4
Place the tag. Click to position the keynote tag and leader endpoint. Adjust with grip handles.
5
Add a Keynote Legend: View tab → Schedules → Keynote Legend. Place on sheet to decode all codes used in that view.

Example: Text Note with Leader

PROVIDE BLOCKING AT GRAB BAR LOCATIONS ← Leader points to wall Floor Plan View

Example: Material Keynotes in Section

Wall Section Detail 04.21.13 07.21.00 09.21.16 Brick Veneer Air Barrier Insulation Vapor Retarder Gypsum Board

Example: Placing a Detail Component

1
Open a detail or section view where you need to show construction specifics (e.g., a wall section at a window head).
2
Annotate → Detail → Component. In the Type Selector, browse for the family (e.g., "Batt Insulation" or "Break Line").
3
Click to place the component in the view. For repeating items like insulation, use Repeating Detail Component to fill a region automatically.
4
Adjust properties: Change line weight, pattern, and visibility in the detail component's family type properties.

Common Mistakes

✕ Text Instead of Keynotes
Typing full material descriptions as text notes leads to inconsistency. If specs change, you must find and update every note individually.
✕ Missing Keynote File
Forgetting to set the keynote file path in Keynoting Settings. Revit will show "?" tags when the file is not linked or the path is broken.
✕ Wrong View Type
Placing detail components in a 3D view or a plan view where they don't make sense. Detail components belong in section, detail, and drafting views.

Question 1 of 5

What is the primary advantage of using keynotes instead of text notes for material callouts?

Question 2 of 5

Which type of keynote requires you to manually select a code from the keynote table?

Question 3 of 5

Where should you primarily place detail components in Revit?

Question 4 of 5

A coworker's keynote tags all display "?" instead of codes. What is the most likely cause?

Question 5 of 5

Which statement about text note properties in Revit is correct?