Text & Keynotes — Add text, keynotes, and detail components (intro)

Historical Context & Motivation

Architectural documentation has always demanded a dialogue between drawing and written language. Before the advent of digital tools, architects painstakingly lettered every note, dimension, and specification by hand using Leroy lettering sets or Rapidograph pens, a process that consumed a remarkable portion of a draftsperson's time. The emergence of Computer-Aided Design (CAD) in the 1980s introduced typed text and leaders, but annotations remained largely disconnected from the geometry they described. When Autodesk launched Revit in 2000, the paradigm shifted dramatically: text, keynotes, and detail components became view-specific annotation objects that live inside the Building Information Model, scaling automatically to the view and updating whenever the model changes.

The central question this lesson addresses is deceptively simple: how do you communicate design intent—materials, assemblies, conditions—to contractors and fabricators who will never interact with your 3D model? The answer lies in Revit's triad of annotation tools: text notes, keynotes, and detail components. Understanding when and how to deploy each one is essential for producing documents that are both legible and contractually precise.

Core Principles & Definitions

Before placing a single note, it is important to understand the conceptual framework that governs Revit annotations. All annotations in Revit are view-specific elements—they exist only in the view where they are placed and do not appear in the 3D model. This distinction separates them from model elements like walls and floors. Annotations automatically adopt the scale of their host view, so a text note set to 3/32" will print at that size regardless of whether the view is 1:50 or 1:200. Revit groups its annotation tools into three primary categories, each serving a distinct documentation purpose and carrying different levels of intelligence.

Visual Explanation — The Annotation Ecosystem

The diagram above captures the essential spatial and conceptual relationship among the three tools. Notice that the detail component is drawn directly within the section view, living alongside the model geometry it supplements—in this case, the wavy hatch representing batt insulation within a wall cavity. The keynote floats outside the wall but connects via a leader line; its content is not typed by the user but resolved from the keynote table, ensuring that every instance of '07 21 13' on every sheet in the project maps to the exact same description. The text note near the foundation is a unique instruction that no keynote code covers—a reminder to the contractor to cross-reference a geotechnical report. As a visual arts student, you can think of these layers as analogous to the distinction in printmaking between the plate (the model), the ink (detail components), and the marginal annotations (text and keynotes) that guide the viewer.

How It Works — Placement & Data Flow

Text Note Placement

To place a text note, navigate to the Annotate tab on the ribbon and click Text. The options bar presents two fundamental choices: leader (one-segment, two-segment, or curved) and no leader. When you choose a leader, you first click the point on the element you want to annotate, then click to place the elbow, and finally click to set the text box location. Text notes support basic formatting—bold, italic, underline—and can be rotated. The text note type controls font, size, background color, and leader arrowhead style. In practice, a firm's template will pre-define two or three text types (e.g., '3/32" Arial' for general notes, '1/8" Arial Bold' for titles) so that all users produce uniform documents.

Keynote Placement & the Keynote Table

Keynotes operate through a lookup mechanism. Each element or material in the model can have a Keynote parameter—a text string such as '07 21 13'—which corresponds to a row in the project's keynote file (a tab-delimited .txt file). When you click Annotate → Keynote, Revit offers three modes: Element Keynote (reads the keynote assigned to the element's type), Material Keynote (reads the keynote assigned to the specific material face you click), and User Keynote (lets you pick any value from the table without attaching to an element). The keynote tag then displays the code, and a Keynote Legend schedule placed on the sheet automatically lists only the keynotes visible in that view, providing the decoder ring for the reader.

Detail Component Placement

Detail components are loaded from the Revit family library (or custom .rfa files) via Annotate → Detail Component. Because they are 2D families, they appear only in the view in which they are placed—plan, section, or detail. A detail component can include line work, filled regions, and masking regions, making it ideal for representing items like rigid insulation, steel angles, or sealant joints that are too fine-grained to warrant full 3D modeling. Detail components carry subcategory, keynote, and visibility parameters, meaning they can be tagged with keynotes and filtered in schedules just like model elements. Their draw order is controlled through the Arrange tools (Bring to Front, Send to Back), which function much like layer ordering in Adobe Illustrator.

Detailed Breakdown — When to Use Each Tool

Choosing between text notes, keynotes, and detail components is not arbitrary—it depends on the nature of the information, the need for consistency, and the graphic requirements of the document set. A good rule of thumb is that if a note will appear in more than one location across the project, it belongs in the keynote system rather than as freeform text. If the information is inherently graphic—representing a physical assembly like flashing or blocking—it belongs as a detail component. The table below maps common documentation scenarios to the recommended tool.

Worked Example — Annotating a Wall Section Detail

Let us walk through the complete process of annotating a typical exterior wall section in Revit. The goal is to label the insulation, sheathing, and cladding with keynotes, add a detail component for a sealant joint at a window head, and place a text note for a unique field instruction.

Strengths & Limitations of Each Tool

Connection to Advanced Documentation Workflows

The introductory annotation tools covered in this lesson serve as the foundation for more sophisticated documentation strategies used in professional practice. As projects grow in complexity, firms adopt workflows that extend these basic concepts into automated, data-driven systems. Understanding the trajectory from simple text placement to intelligent annotation helps you appreciate why mastering the fundamentals matters.

As you advance in your study of Revit, pay particular attention to shared parameters and tag families, which extend the keynote concept into a fully parametric annotation system. In many firms, the documentation phase accounts for 40–60% of total project hours, so even incremental efficiencies in annotation—such as switching from text notes to keynotes for recurring material labels—can yield significant time savings across a project's lifecycle.

Practice Problems

Lesson Summary