Revit keynotes are short codes placed on drawings that point to a longer note stored in an external, tab-delimited text file. Each code is pulled from the keynote parameter of an element, a material, or a user entry, and a keynote legend on the sheet translates every code back into full text.
Keynoting looks like a minor annotation feature until you inherit a project where half the notes are typed text and the other half are tags reading "?". Once the keynote file, the numbering method, and the legends agree, notes update across every sheet from a single source and the drawings stay tied to the specifications.
What Are Keynotes in Revit?
A keynote is a tag that displays a value instead of free text. Autodesk's Revit 2026 keynotes documentation states that a keynote parameter is available for all model elements, including detail components, and for materials. The values that fill that parameter come from a separate text file, not from the model itself.
That separation is what makes Revit keynotes worth the setup. Typed text notes live inside individual views, so changing "gypsum board" to "abrasion-resistant gypsum board" means hunting through every view by hand. A keynote stores the description once, in the file. Edit the file, reload it, and every legend updates.
Autodesk's Revit LT help draws a useful line between two kinds of notes. Reference keynotes identify materials and products and connect the drawing to the specifications. Sheet keynotes give instructional information but are not connected to the specifications. Most offices use the first kind for anything with a spec section and the second for instructions like "verify in field." If you are still choosing a platform, our comparison of Revit vs ArchiCAD vs AutoCAD covers where Revit's documentation tools pull ahead.
The Keynote File Format
Every Revit keynote in a project traces back to one plain text file. Autodesk's page About Editing the Keynote File explains that keynotes are defined in a tab-delimited text file, which you can manage in Excel or a similar spreadsheet and export back to tab-delimited format.
How the columns work
Each row holds up to three values separated by a Tab character: the key that appears in the tag, the description that appears in the legend, and an optional parent key that places the row in the tree view of the Keynotes dialog. Rows without a parent become headings. Autodesk's own example shows the pattern:
00000 Division 00 - User Notes 00001 User Note 1 00000 00002 User Note 2 00000 00001.A1 User Note 1a 00001
Here "00000" is a heading, "00001" and "00002" sit under it, and "00001.A1" sits under "00001". The gaps are real Tab characters. A row built with spaces reads as one long key with no description.
⚠️ Common Mistake to Avoid
Opening a keynote file in Excel without setting the key columns to Text. Microsoft's support article on keeping leading zeros confirms that Excel automatically removes them from numbers, so a key such as "00000" loses its zeros and the next save breaks every parent reference that relied on it. Import the file through Excel's text import and set columns one and three to Text before editing.
Encoding, location, and the sample file
Revit installs a starter file called Keynotes_Sample.txt with its content library. Autodesk's About Keynote Files page gives the default location as %ALLUSERSPROFILE%\Autodesk\RVT 2026\Libraries\ plus your locale folder, and notes the file can sit on a network server so every user reads the same version.
Two details catch people out. For non-Latin characters, Autodesk advises changing the encoding from ANSI to Unicode with Save As. And edits never appear in an open session: close and reopen the project, or reload the file from Keynoting Settings.
Element, Material, and User Keynotes
Revit offers three keynote types under Annotate tab, Tag panel, Keynote drop-down. They look the same on paper but pull their values from different places, which changes how you maintain them.
Element keynotes
An element keynote applies to an entire element, such as a wall, detail component, or door. The value usually lives in the Keynote type parameter, so every instance of that type carries it. Set it once in Type Properties and every door of that type tags correctly in plan, elevation, and section.
Material keynotes
A material keynote applies to a material painted on a surface or assigned to a component layer. Every object using that material inherits the value, which makes wall sections fast: key "Rigid Insulation" once and every assembly using it can be tagged layer by layer. Autodesk notes that material keynotes do not work with the insulation drafting tool, certain detail components, or wireframe views, and the Revit LT help adds that the material must be displayed, which means Medium or Fine detail level.
User keynotes
User keynotes cover commonly used notes or phrases that address documentation issues rather than a specific element or material. The value is stored on the tag, so the same wall can carry an element keynote describing what it is and a user keynote telling the contractor what to do. Autodesk notes that these user notes must be added to the provided keynote file or to one you create.
Keynote types compared
The table sums up where each type stores its value and when to use it.
| Feature | Element | Material | User |
|---|---|---|---|
| What gets tagged | Whole element (wall, door, detail component) | Painted surface or component layer | Any element, as an instruction |
| Where the value lives | Keynote parameter of the type | Keynote field of the material | On the keynote tag |
| Typical use | Products and assemblies | Layered wall, roof, floor sections | Site instructions, coordination notes |
| Known limits | Nested components must be shared | Not in wireframe or insulation tool | Not tied to model data |
Placing a Keynote Tag
The Revit 2026 keynoting tutorial lists a short workflow:
- Go to Annotate tab, Tag panel, Keynote drop-down, and pick Element, Material, or User.
- In the Type Selector, choose Number, Number - Boxed (Large or Small), or Text.
- Toggle the Leader option and set horizontal or vertical orientation.
- Click the element or material, then place the leader segments and the tag.
If the element already has a keynote value, it appears in the tag automatically. If not, the Keynotes dialog opens so you can pick one from the tree, and that choice is written back to the parameter for the next tag.
💡 Pro Tip
Assign keynote values to types in your project template before anyone starts tagging. When the Keynotes dialog pops up mid-drawing, people grab the nearest plausible value and you end up with three keys for the same gypsum board. A type schedule with the Keynote field exposed makes the audit fast.
A well-built template saves most of this setup, and the Revit collection in our store has templates and families to start from. Keynote tags should also follow the same graphic rules as the rest of your annotation; our guide to section cut symbols and drawing annotation covers how tags and leaders share a crowded detail sheet.
Keynoting Settings: Path and Numbering
The Keynoting Settings dialog controls two decisions that are hard to change late in a project: where Revit finds the file, and how it numbers tags.
Path types
Autodesk's Keynoting Settings reference defines three options. Absolute points to a specific folder on your PC or a network server. Relative finds the file where the project file or central model is located. At Library Locations uses the library folder set by the installation or network deployment. Relative suits projects that travel with their keynote file; Absolute suits offices with one master file on a server. A Reload button refreshes the table, and View opens it read-only.
Numbering methods
By Keynote shows the value stored in the parameter, such as "09 29 00.A1". By Sheet numbers keynotes in order of creation, so tags read 1, 2, 3, while the real key stays stored in the parameter. The catch: under By Sheet, no number appears until the view is placed on a sheet. Blank tags on unplaced views are expected behavior, not a broken file.
📐 Technical Note
Autodesk's About Keynotes page explains that the keynote value is stored as a parameter on the element or material, and that keynotes in a project stay linked to their source keynote table, which is where the description comes from. A key that no longer exists in the file has no description left to read. Our recommendation is to retire old keys mid-project by editing their description, for example marking them as not used, rather than deleting the row.
Keynote Legends
A tag alone is just a code. The keynote legend turns "07 21 00.B2" into readable text. Create one from View tab, Create panel, Legends drop-down, Keynote Legend. It comes with two predefined fields, Key Value and Keynote Text, plus the usual Filter, Sorting/Grouping, Formatting, and Appearance tabs.
Filtering by sheet
Unfiltered, a legend lists every keynote in the project. Autodesk's page on how to filter a keynote legend by sheet gives the fix: open the legend, click Edit next to Filter in Properties, and enable Filter by Sheet. The legend then shows only keynotes visible in views on its sheet. Because keynote legends can be placed on multiple sheets, one legend view can serve the whole set.
Filtering by division
Legends can also be split using the Key Value field with the Begins With operator. Enter "15" and only keys starting with 15 appear. Large sets often run one legend per group, such as finishes, so each stays readable. Most firms park legends in a column beside the title block so readers always know where to look.
Keynotes and Specifications
Revit keynotes earn their keep when the key matches a specification section. Many US offices build keynote files around CSI MasterFormat, the Construction Specifications Institute's classification for organizing documentation by work results. A key like "09 29 00.A1" tells the contractor which section governs that gypsum board.
Watch the numbering in old samples. Autodesk's division filter example uses "division 15" with a heading of "15000", which follows the older 16-division MasterFormat layout. Current MasterFormat uses six-digit numbers read in pairs, such as 03 30 00. Check which system a file follows before assigning keys.
📌 Did You Know?
MasterFormat is not frozen. CSI's standards overview lists MasterFormat 2026 as its latest release, with 2,185 new and 617 reorganized listings. A keynote file built on an earlier edition still works in Revit, but some keys may no longer match your specifier's section numbers.
CSI also maintains UniFormat, which classifies a building by elements and systems and suits early design and cost analysis. For more on how spec sections are structured, see our primer on MasterFormat basics. Keynote depth should also match model maturity: a product-specific key on a generic wall promises more than the model holds, a point covered in our article on LOD in BIM.
Where to Go From Here
Your Next Step: Open Keynoting Settings in your current project, note the path type and numbering method, then open the keynote file in a text editor and confirm its keys follow the specification numbering your office uses today. Fixing a mismatched file before the next issue is far cheaper than retagging a full set.
To see keynoted details in a complete set, our Architectural Revit Project Pack includes project drawings to study.
Frequently Asked Questions
Why don't my keynote file changes show up in Revit?
Revit does not pick up edits to the keynote file during an open session. Close and reopen the project, or click Reload in the Keynoting Settings dialog, and the updated values appear in tags and legends.
What is the difference between element and material keynotes?
An element keynote describes a whole object, such as a door or wall, and is usually stored on the element type. A material keynote describes a material on a surface or in a component layer, and every element using that material inherits it.
Why are my keynote tags blank?
The most common cause is By Sheet numbering, where tags show no number until their view is on a sheet. Other causes include an empty type or material parameter, a nested component that is not shared, or a material keynote in a wireframe view.
Can a keynote legend show only the notes on one sheet?
Yes. Open the legend, click Edit next to Filter in the Properties palette, and enable Filter by Sheet. It then lists only keynotes visible in views on that sheet, even when the same legend appears on many sheets.
Comments (0)
Back to Architecture and Design Blog