Home/Plugins/Keynotes Editor
AUTODESK REVIT PLUGIN
Annotations & DataIn Development

Keynotes Editor

Edits Revit keynote TXT files in a hierarchical tree, with add/edit/delete, drag-and-drop reorganisation, validation, duplicate repair, undo, backups and Revit keynote reload.

Keynotes Editor conceptual interface

Overview

Keynotes Editor is a Revit API add-in for managing the keynote TXT file used by an active Revit project. It can load the project's current keynote file or open another TXT file, then display the keynote hierarchy as a tree with Key Value and Keynote Text. Users can add root or child keynotes, edit values and text, delete complete branches, move keynotes to another parent, or reorganise the hierarchy by drag and drop. The editor includes Key Value search, up to 50 undo snapshots, duplicate-key detection and automatic duplicate repair, and validation for missing fields, invalid parent keys, tabs and line breaks. Saving creates a timestamped backup, supports Save As, preserves header/comment content and detected file encoding, and can reload the Revit Keynote Table immediately. The edited file can also be set as the project's current keynote source before reloading. Separate project targets are included for Revit 2024 and Revit 2025.

Key features

  • Load the keynote TXT file currently referenced by the active Revit project.
  • Browse and load any Revit keynote TXT file for review or editing.
  • Hierarchical tree editor showing Key Value and Keynote Text.
  • Add root keynotes and child/subkey keynotes.
  • Edit Key Value and Keynote Text while keeping child Parent Keys coordinated when a parent key is renamed.
  • Delete a selected keynote together with its complete nested branch.
  • Move a keynote to another parent or back to the root level, with protection against circular parent relationships.
  • Drag and drop keynotes as a subkey, before the selected row or after the selected row.
  • Automatic tree scrolling during drag-and-drop operations.
  • Search by Key Value with Find Next for repeated matches.
  • Undo up to 50 unsaved modifications using the toolbar, context menu or Ctrl+Z.
  • Validate duplicate keys, empty required fields, invalid parent keys, tab characters and line breaks.
  • Auto-fix duplicate Key Values using unique -DUP01, -DUP02 and similar suffixes.
  • Save with an automatic timestamped backup beside the keynote file.
  • Save As to a new keynote TXT file while preserving header/comment lines and detected text encoding.
  • Reload the Revit Keynote Table after saving, with an option to set the edited file as the current keynote source first.
WORKFLOW

How the plugin fits into production

  1. 01

    Open a Revit project that uses keynote settings.

  2. 02

    Launch Keynotes Editor from the Revit ribbon.

  3. 03

    Load the current project keynote file or browse to another keynote TXT file.

  4. 04

    Review the keynote hierarchy and use Key Value search when needed.

  5. 05

    Add, edit, delete, re-parent or drag-and-drop keynote entries.

  6. 06

    Use Undo or Ctrl+Z to reverse unsaved changes when required.

  7. 07

    Run duplicate repair if needed, then validate the keynote data.

  8. 08

    Save the existing file or use Save As; a timestamped backup is created when overwriting an existing file.

  9. 09

    Optionally set the edited TXT file as the current Revit keynote source.

  10. 10

    Reload the Revit Keynote Table and continue documentation using the updated keynote data.

Interested in Keynotes Editor?

Currently under development and controlled testing. The editor writes directly to external keynote TXT files, so users should review hierarchy changes, duplicate-key repairs and validation results before formal project use. A timestamped backup is created when overwriting an existing keynote file, and the Revit keynote table can be reloaded after saving.

Contact JTABIMTools