Revit keynotes are annotation tags that pull their number and description from a keynote text file. Instead of typing the same note again and again, you assign a keynote value to an element, material, or custom user note, then show the used notes in a keynote legend on your sheets.
If you are just trying to add your first keynote in Revit, use this quick workflow: go to Annotate > Tag > Keynote, choose Element, Material, or User, click the object or material in the view, then choose the keynote value from the keynote file. For sheet notes, create a Keynote Legend from View > Legends > Keynote Legend and enable Filter by Sheet so each sheet only lists the keynotes visible on that sheet.
Updated July 2026: this guide now includes the current Revit 2026 keynote workflow, sheet-specific keynote legend settings, linked model notes, cloud keynote file reload tips, and common fixes when keynote legends show blank or incorrect rows.
Download Free Revit Keynote File Maker
Use the form below to get the Keynote File Maker and create a Revit-ready tab-delimited keynote TXT file from a spreadsheet.
What Are Keynotes in Revit?
Keynotes in Revit connect drawing annotations to a controlled list of notes. The list is stored in a separate tab-delimited TXT file, and Revit uses that file to resolve the keynote value and keynote text shown in tags and keynote legends.
This is different from manually typing text notes. When keynote values are assigned consistently, your drawings and specifications stay easier to coordinate because the same wall type, material, door, detail component, or custom note can use the same reference across multiple views and sheets.
Reads the keynote value assigned to an element type, such as a wall, door, window, or detail component.
Reads the keynote value assigned to a material, including materials used in compound layers or painted surfaces.
Creates a custom note that is not tied to a specific element or material. Use it for sheet-specific documentation notes.
As a rule, use Element Keynotes or Material Keynotes when the note should follow the model data. Use User Keynotes only when the note is a drawing instruction or a special note that does not belong to a modeled object.
How to Add a Keynote in Revit
To add a keynote tag in Revit, first decide whether the note should come from the element, the material, or a user-selected note. Then place the tag in the view and choose the correct keynote value if Revit does not already find one.
Step 1: Open the Keynote Tool
Go to Annotate tab > Tag panel > Keynote. From the drop-down menu, select one of the three keynote types: Element Keynote, Material Keynote, or User Keynote.
Step 2: Choose the Tag Type and Leader
In the Properties palette, choose the keynote tag style. Common tag styles show the keynote number, boxed number, or keynote text. Turn the Leader option on or off depending on how you want the tag to point to the object.
Step 3: Click the Element or Material
Click the element, detail component, or visible material face in the view. If the selected object already has a keynote value, Revit places the tag automatically. If it does not, the Keynotes dialog opens so you can choose the value from the keynote file.
Step 4: Place the Leader and Tag
Click to place the leader segment, then click again to place the tag. After placement, select the keynote tag if you need to adjust its type, orientation, leader, or text display.
If you want the keynote tag to display the description instead of the number, select the tag, click Edit Type, and adjust the label settings in the keynote tag family or type. For most construction documents, the tag shows the number and the keynote legend shows the description.
How to Assign Keynotes to Elements and Materials
The fastest Revit keynote workflow is to assign keynote values before tagging. That way, the tag reads the model data instead of forcing you to pick a keynote every time you place a tag.
| Keynote Type | Where to Assign It | Best Use |
|---|---|---|
| Element keynote | Element Type Properties > Identity Data > Keynote | Walls, doors, windows, detail components, casework, and other typed elements. |
| Material keynote | Material Browser > Identity tab > Keynote | Finish materials, wall layers, floor layers, roofs, painted surfaces, and visible material faces. |
| User keynote | Placed from Annotate > Keynote > User | Drawing-specific notes, installation notes, alignment notes, or notes not tied to model data. |
For material keynotes, make sure the material is actually visible in the view. If you cannot select the material face, change the view detail level to Medium or Fine, check the view range and visibility settings, or place the keynote in an elevation, section, or detail where the material geometry is visible.
Keynote Settings in Revit
To manage the keynote file used by the project, go to Annotate > Tag > Keynote > Keynoting Settings. This dialog shows the current keynote file path, lets you browse for a different file, reloads the current keynote table, and controls the numbering method.
By Keynote vs By Sheet
By Keynote displays the actual keynote value stored in the keynote parameter or selected from the keynote table. This is usually best when your office uses a specification-based keynote system, such as CSI-style numbers.
By Sheet numbers keynotes according to their order on each sheet. Revit still stores the selected keynote value, but the tag number shown on the sheet becomes a sequential sheet number. One important detail: a keynote tag may not show a number until the view containing the keynote tag is placed on a sheet.
Best practice: keep the keynote file on a shared network location, project folder, or managed cloud location that every project user can access. For linked Revit models, use the same keynote file name/path strategy in the host and linked models to avoid mismatched legends.
How to Create or Edit a Revit Keynote File
A Revit keynote file is a plain text file with tab-separated columns. You can edit it in Notepad, Excel, Google Sheets, or another spreadsheet editor, but it must be saved back as a tab-delimited TXT file before Revit can use it correctly.
Revit keynote files normally use three pieces of information:
| Column | What It Means | Example |
|---|---|---|
| Key Value | The keynote number or code shown in the tag or legend. | 07 21 00 |
| Keynote Text | The description shown in the keynote legend. | Thermal Insulation |
| Parent / Nesting Key | The parent heading that organizes the keynote tree. | 07 00 00 |
Example Revit Keynote TXT Structure
07 00 00[TAB]Thermal and Moisture Protection 07 21 00[TAB]Thermal Insulation[TAB]07 00 00 07 21 13[TAB]Board Insulation[TAB]07 21 00 07 21 16[TAB]Blanket Insulation[TAB]07 21 00
In the real TXT file, replace [TAB] with an actual tab character. Do not use multiple spaces in place of tabs. Headings can have no parent key, while child keynote rows use a third column to point back to their parent.
Edit the File with the Keynote File Maker
If you prefer editing in a spreadsheet, use the Keynote File Maker to organize the key value, description, and nesting key columns, then export a clean TXT file for Revit.
- Open the keynote spreadsheet.
- Edit or add keynote rows in the table.
- Keep each key value unique.
- Use the nesting key to organize child notes under the correct parent category.
- Export the sheet as a tab-delimited TXT file.
- In Revit, go to Keynoting Settings and click Reload.
After editing the keynote file, Revit does not always update the current project session automatically. Use Reload in Keynoting Settings, or close and reopen the project if the old values still appear.
How to Create a Keynote Schedule in Revit
In Revit, the keynote schedule is called a Keynote Legend. It lists the keynote values and keynote text used in the project or on a sheet. You can place the same keynote legend on multiple sheets.
- Open the view or project where keynotes have already been placed.
- Go to View tab > Create panel > Legends drop-down.
- Click Keynote Legend.
- Name the legend, then click OK.
- Keep the default fields Key Value and Keynote Text, or format the columns as needed.
- Place the keynote legend on your sheet.
To make the keynote legend sheet-specific, open the keynote legend from the Project Browser, go to Properties > Filter > Edit, then enable Filter by Sheet. After that, the legend should show only the keynotes visible in views placed on the sheet where the legend is placed.
If Filter by Sheet is grayed out:
- Check whether the schedule was split and placed across sheets.
- If it was split, recreate the keynote legend without using Split and Place.
- Then open the keynote legend properties again and enable Filter by Sheet.
You can also sort, group, and format the keynote legend like other Revit schedules. For clean construction sheets, keep the legend narrow, sort by key value, and avoid showing unused project-wide keynotes unless the sheet really needs a master list.
Keynotes in Linked Revit Models
Keynotes can work with linked models, but the setup must be deliberate. If you need linked model elements to appear correctly in a host model keynote legend, keep the host and linked model keynote settings aligned.
- Use the same keynote file name and path strategy in the host and linked model.
- Use a relative file path when the keynote file travels with the project.
- Use By Keynote when the host and link need the same keynote value.
- For linked elements to appear in the host keynote legend, add the keynote tags to linked elements from the host model.
- User keynotes placed directly inside the linked model may be visible in the host, but they are not the same as re-tagging those notes from the host model.
Revit Keynote Troubleshooting
If your Revit keynote tag or keynote legend is not behaving as expected, check these common issues first.
| Problem | Likely Cause | Fix |
|---|---|---|
| Keynote value is missing | The element, material, or user note has no keynote assigned. | Select the correct keynote from the Keynotes dialog or assign it in type/material properties. |
| Keynote file changes do not appear | The keynote file was edited after Revit loaded it. | Go to Keynoting Settings and click Reload, or close and reopen the model. |
| Keynote legend shows keynotes from every sheet | Filter by Sheet is not enabled. | Open the legend properties and enable Filter by Sheet. |
| Filter by Sheet is grayed out | The keynote legend was split across sheets. | Recreate the legend without using Split and Place, then enable Filter by Sheet. |
| Material keynote cannot be selected | The material is not visible in the current view. | Use Medium/Fine detail level or tag the material in a section, elevation, or detail view. |
| Cloud model warns that resources are not current | The keynote TXT file changed after the model cached it. | Reload the keynote file and check Desktop Connector/cache status if the file is stored in Autodesk Docs. |
| Linked model keynotes do not show in host legend | The keynote was placed only inside the linked model or file paths/settings differ. | Align keynote settings and tag linked elements from the host when they must appear in the host legend. |
Best Practices for Revit Keynotes
- Use model-based keynotes first. Element and material keynotes are easier to coordinate than loose user notes.
- Keep keynote text generic. Use wording that matches the specifications, not long descriptions that may change during the project.
- Store the keynote file in a shared location. Everyone on the project should load the same TXT file.
- Reload after edits. If you update the TXT file, reload it from Keynoting Settings before checking tags or legends.
- Filter legends by sheet. This keeps each sheet readable and avoids huge keynote schedules.
- Check the tag source. If a keynote is wrong, confirm whether the tag is reading Element, Material, or User data.
- Avoid duplicate key values. Each keynote value should point to one clear description in the same keynote file.
- Coordinate linked models early. Decide whether the host, links, or each discipline controls keynote placement before documentation starts.
Keynotes are most useful when the office standard is clear before sheets are built. If every team member uses the same keynote source, the keynote legend becomes a reliable coordination tool instead of a manual note list.
Keynote vs Tag vs Generic Annotation
A tag reads data from a model element, such as type mark, material, room number, or other parameters. A keynote is a special annotation that reads a keynote value and description from a keynote file. A generic annotation is a 2D annotation family used for symbols or notes that do not need to pull from the Revit keynote system.
Use keynotes when the note should be standardized and scheduled in a keynote legend. Use regular tags when you need model parameter data. Use generic annotations or note blocks when the note is purely symbolic or not tied to the project keynote file. If you need more control over annotation families, read this guide to annotation symbols in Revit.
FAQ: Revit Keynotes
How do I add a keynote in Revit?
Go to Annotate > Tag > Keynote, choose Element, Material, or User, then click the element or material in the view. If no keynote value is already assigned, select one from the Keynotes dialog.
Where is the Revit keynote file stored?
The sample keynote file is installed with the Revit content library. In Revit 2026, the default standalone content location is typically under %ALLUSERSPROFILE%\Autodesk\RVT 2026\Libraries\<locale and language>. Many offices move the keynote file to a network, project, or cloud folder so the whole team uses the same file.
How do I reload a keynote file in Revit?
Open Annotate > Tag > Keynote > Keynoting Settings, then click Reload. If the keynote table still does not update, close and reopen the project.
How do I create a keynote schedule in Revit?
Use View > Create > Legends > Keynote Legend. Revit creates a schedule-like legend with Key Value and Keynote Text fields. Place it on a sheet and enable Filter by Sheet if you want a sheet-specific keynote list.
Why are my Revit keynotes blank?
Blank keynotes usually mean the tag has no assigned keynote value, the keynote value does not exist in the TXT file, the file has not been reloaded, or the legend is filtering keynotes that are not visible on the sheet.
Should I use element keynotes or user keynotes?
Use element keynotes when the note belongs to a modeled object or detail component. Use user keynotes only for notes that are not tied to model data, such as sheet-specific instructions or special drafting notes.
Conclusion
Revit keynotes are one of the best ways to keep drawing notes consistent across views and sheets. The core workflow is simple: assign keynote values to elements or materials, place keynote tags, manage the tab-delimited keynote TXT file, and create a keynote legend for your sheets.
For the cleanest documentation workflow, standardize the keynote file early, reload it after edits, use Filter by Sheet on legends, and reserve user keynotes for notes that cannot be handled by element or material data. You can also read how legends work in Revit and how to sync Revit with Excel if you want to improve the full annotation workflow.
Mohamed Fakhry has helped thousands of architects and designers find their next project with step-by-step guidance on his blog, mashyo.com. About Mohamed
His journey began during his university years when he recognized the need for information-rich 3D models to accelerate learning and improve production processes. Now, Mohamed shares his expertise through Revit tutorials that are accessible to all.
