How to Add Keynotes in Revit

Seven steps in Revit, or one sentence in Mira.

Do it with Mira
Quick answer

In Keynoting Settings (Annotate tab › Tag panel › Keynote drop-down), load your keynote file. Then pick Element, Material or User Keynote from that drop-down, choose a style in the Type Selector and click the element. A Keynote Legend on the sheet explains the numbers.

Or, just ask Mira to fill in the Keynote on the wall types you've selected.

The manual way

How to do it in Revit

  1. Step 1: Load your keynote file

    Click the Annotate tab › Tag panel › Keynote drop-down, choose Keynoting Settings, click Browse and open your keynote file, a tab-delimited .txt file. Under File Path, pick Absolute (a fixed folder or network path), Relative (the folder that holds the project file or central model) or At Library Locations (the folder your Revit installation or deployment sets) (Autodesk Help: Keynoting Settings Dialog). A file on a network server is available to everyone.

    Revit 2025 installs three samples built on CSI MasterFormat: RevitKeynotes_Imperial.txt, RevitKeynotes_Imperial_2004.txt and RevitKeynotes_Metric.txt. Revit 2026 and 2027 install only Keynotes_Sample.txt, which shows how to build your own (Autodesk Help: About Keynote Files).

  2. Step 2: Choose a numbering method

    In the same dialog, under Numbering Method, choose By keynote to show each keynote's own value from the file (such as 07 42 13.A11), or By sheet to number keynotes in the order you create them. With By sheet, a tag shows no number until its view is placed on a sheet. Click OK.

  3. Step 3: Give types and materials their keynote values

    Tags fill themselves in when the element or material already has a value. For an element, click Edit Type in the Properties palette and click the Keynote value under Identity Data to pick one. It is a type parameter, so every instance of the type gets it (Autodesk Help: Have You Tried: Keynoting). For a material, open Manage tab › Settings panel › Materials and set Keynote on the Identity tab; elements that use the material inherit it (Autodesk Help: Change the Identity Data of a Material).

    Expect Autodesk's families to arrive blank. Autodesk says the value is empty in the default families, and the What's New for Revit 2026 notes that CSI reference values were removed from Revit's content files (Autodesk Help: What's New in Revit 2026, Dynamo Updates 3.4.1).

  4. Step 4: Pick the keynote type and style

    From the Keynote drop-down, choose Element Keynote (reads the element's type), Material Keynote (reads the material you point at, such as one layer of a wall) or User Keynote (any note in the file, not linked to the element). In the Type Selector, pick a style: Autodesk lists Number, Number - Boxed (Large or Small) and Text. Numbers need a keynote legend to be read; Text puts the keynote's words in the tag (Autodesk Help: Add a Keynote to a View).

    Turn Leader on or off and set the tag's orientation. Revit 2027 removed the Options Bar and moved its controls to the Properties palette and the ribbon (Autodesk Help: Options Bar Removal).

  5. Step 5: Click to place the keynote

    Click the element or material (the arrowhead lands there), click a second point for the leader, then click where the tag sits. If there is no keynote value yet, the Keynotes dialog opens: pick one and click OK. Cancel leaves the keynote empty (Autodesk Help: About Types of Keynotes).

    To line up several keynotes, select them and use the Multiple Align panel (added in Revit 2025) on the Modify | Keynote Tags tab (Autodesk Help: About Keynotes).

  6. Step 6: Add a keynote legend to the sheet

    Click the View tab › Create panel › Legends drop-down and choose Keynote Legend. It is a schedule with Key Value and Keynote Text already in its fields (Autodesk Help: About Keynote Legends). Drag it from Legends in the Project Browser onto the sheet; one legend can go on many sheets.

    To list only the keynotes visible in that sheet's views, open the legend, click Edit next to Filter in the Properties palette and select Filter by Sheet (Autodesk Help: Filter a Keynote Legend by Sheet).

  7. Step 7: Edit the keynote file, then reload it

    Open the .txt file in Excel or a text editor; the Keynotes dialog in Revit only displays it. Each row is a key value, the keynote text and the key value of its parent heading, separated by tabs. Main headings come first, with no parent; a note under heading 00000 reads 00001 (tab) User Note 1 (tab) 00000 (Autodesk Help: About Editing the Keynote File).

    Save it as tab-delimited text, then click Reload in Keynoting Settings; otherwise changes appear only after you close and reopen the project. Every keynote that uses a changed value updates. Print or export with an out-of-date file and Revit warns that resources are not up to date.

What to watch for

A number with no text means the keynote value isn't in your project's keynote file, which happens when a family was keynoted against another file. Pick a value from your file in the Keynotes dialog, or add the missing value to the file and reload.

Changing an element keynote changes the type. Every instance of that type, in every view, gets the new value. For a one-off note, use a User Keynote; it won't follow the element, so you coordinate it by hand.

Material keynotes need to see the material. The element must be visible, with the view's detail level at Medium or Fine. They don't work on insulation, detail lines or filled regions, or in wireframe views, and in a 3D view any keynote needs the view locked first (Save Orientation and Lock View).

Linked models need the same keynote file path. Revit compares the path and file name in the host and the link, not the contents, and shows an error if they differ. Keynotes placed in the host on linked elements appear in the host's legend; keynotes placed inside the linked file don't.

At firm scale the drift is in the values, not the file. One keynote file on a server keeps the words consistent. But each project stores its own path, families from Autodesk's library arrive with Keynote blank and details copied from old jobs carry values from another file. Keep keynote values on the families and detail components your firm treats as firm standards, so tags fill themselves in. For types that arrive blank, the AI agent for Revit sets the Keynote on the wall types you select, after telling you how many walls the change reaches. The keynote file stays yours to manage.

Or, just ask Mira to do it.

Mira is an AI thinking partner for Revit that automates the work you repeat and builds tools your team needs.

  • Type this in Mira

    Set the Keynote to 09 29 00.A1 on the wall types I've selected.

    Keynote is a type parameter, so Mira tells you how many walls the change reaches and waits for your OK, then reads each value back.

QualityFill in keynote values in Revit
Riverside_Medical_Center_ARCH.rvt — Level 02
FileArchitectureStructureAnnotateAnalyzeViewManagePirros
Level 02 ×A-501 Details3D View
Wall typeKeynote
Int - 5/8" GWB on 3-5/8" MSset, 96 walls
Int - 5/8" GWB both sidesset, 58 walls
Furring - 5/8" GWBalready set, 36 walls
2 types keynote set, 154 walls
Mira by PirrosLevel 02
Pirros
ChatSkillsHistory
Set the Keynote to 09 29 00.A1 on the wall types I've selected.
Reasoning
Thought for 3s
Selection(Wall types)
3 types, 1 already set
Warn(Keynote is a type parameter)
Approved, 154 walls
SetParameters(Keynote = 09 29 00.A1)
2 types set, read back
Keynote values set2 of 3
Value
09 29 00.A1
Walls reached
154
Already set
1 type
Undo
one step
Built into Mira
/bulk-set-parameters
In the / menu for everyone
Message Mira
Mira can make mistakes. Verify before you commit.
FAQ

Frequently asked questions.

Can't find what you're looking for?
Get in touch.

Edit the keynote .txt file in Excel or a text editor, keep it tab-delimited and click Reload in Keynoting Settings. To change which keynote an element uses, edit the Keynote value in its type properties.

Keynoting Settings shows the path of the file your project uses. Revit 2026 and 2027 install one sample, Keynotes_Sample.txt, while Revit 2025 installs RevitKeynotes_Imperial.txt, RevitKeynotes_Imperial_2004.txt and RevitKeynotes_Metric.txt. If Revit can't load the file, click Browse in Keynoting Settings and point it at the right one.

An element keynote reads the Keynote type parameter of the element you click. A material keynote reads the keynote assigned to a material, including the materials of a wall's layers. A user keynote can be any entry in the keynote file and isn't connected to the element, so you coordinate it by hand.

Pick the Text style in the Type Selector and the tag shows the keynote's words. A keynote tag can show the number, the text or both, depending on its tag family; select a tag and click Edit Family to change what it shows. If you keep numbers, add a keynote legend so readers can look them up.

They are separate categories with separate tag families. A material tag shows the material's Description, while a material keynote shows the keynote value assigned to the material and asks you to pick one if there is none.

Mira works with Revit 2025, 2026 and 2027, and it is free to download.

Two ways in

Try it yourself.
Or bring it to the firm.

The download is free and takes a minute. The firm conversation is where your standards, your library, and your rollout get built. Start wherever makes sense.

Talk to us about your firm