Home / Guides / Ledger
Data panelLedger

The keynote file, finally managed.

Revit's keynotes live in a bare .txt file nobody dares touch — edited in Notepad, broken on sheets, full of entries no one uses. Ledger puts a real manager over it: see what's actually used, fix what prints as ?, and take the whole library to Excel and back — with nothing written until you've seen the change.

Revit 2024–2027Edits stay drafts until you saveKeeps working when the .txt is offline
Video guideComing soon on BIMIO’s YouTube
Why Ledger exists

Your keynote library is a text file from 2004.

Revit gives keynotes one dialog and no answers: no usage, no history, no safe way to edit. So the .txt gets edited raw — and the mistakes surface on printed sheets, as a ?.

Revit on its own
  • The keynote file is edited in Notepad, in the right tab-format, or it breaks.
  • A tag whose key was renamed prints ? on the client's sheet — silently.
  • Nobody knows which of 1,000 keynotes the model actually uses.
The same library, in Ledger
  • Every keynote shows a dot: tagged, assigned, or never used at all.
  • Every tag that would print ? is listed — one click opens its view, one click deletes the strays.
  • Bulk edits go via Excel, and every add, change and delete is reviewed before the file is touched.
How Ledger works · one afternoon with the library

Open it. See the truth. Fix it. Prove it.

Ledger reads the model's linked keynote file and holds every edit as a draft — the .txt is written once, when you say so, and Revit's keynote table reloads in the same gesture.

The truth, first

Every keynote, with a dot that tells you if it earns its keep.

Ledger opens on the linked keynote file as a tree. Green: a keynote tag is placed. Amber: elements carry the key, but no tag yet. Grey: never used in this model. A category's dot and counts roll up its branch, and expanding a keynote shows the evidence — which views tag it, which family types and materials carry it; views and family types each with a button to go and look. Search by code or text; the filter chips are the same filters as the typed search tokens.

New to Revit: a usage answer per keynote — Revit's own dialog cannot say if a key is used at all.
BIMIO · Ledger — Keynote managerBIMIO
Ledger
1197 keynotes · 214 tagged · 356 used in this model.
Save to fileNew file…Route keynote…Export…Import…Reload
K:\Standards\Keynotes\office-keynotes.txt
Search the library by code or text…
ShowTaggedAssigned, not taggedUnusedIn this viewLockedMaster…Prune…HistoryReport
F30Masonry12 tags · 31 elems
F30/110Facing brickwork, stretcher bond2 tags · 5 elems · 3 types
Tagged in2 tags in 1 view · on 1 sheet: A431
VIEWLevel 02 — Detail at parapet · 2 tagsOpen view
Carried by3 types · 5 instances · Walls
TYPEBasic Wall : FAC Brick 102 — 3 instances · WallsSelect
F30/115Blockwork, fair-faced8 elems
F30/190Glazed brick special
Tagged — a keynote tag is placedAssigned — elements carry it, no tag yetUnused — not in this model
The file itself

No keynote file yet? Start from a published standard, not a blank page.

Revit cannot create a keynote file at all — Ledger writes the .txt and links it. Start from Uniclass 2015's eleven tables, MasterFormat's divisions, OmniClass's fifteen tables, GuBIMclass's functional groups, or empty. And when a file is linked but unreadable, Ledger names the actual obstacle — a disconnected drive, a moved folder, a permission — instead of claiming none is linked. Route keynote… re-points the model at the real file; a new file is never offered as the fix.

New to Revit: a keynote file created from a real classification standard, and an unreachable one named by its actual obstacle rather than reported as missing.
BIMIO · LedgerBIMIO
New keynote file
Revit can’t create a keynote file from scratch — Ledger writes it and links it to this model.
Start from
MasterFormat (CSI) — divisions
Empty
MasterFormat (CSI) — divisions
Uniclass 2015 (NBS/UK) — tables
OmniClass — tables
GuBIMclass — functional groups (starter)

The active MasterFormat divisions (North America). Fill in sections under each. © CSI.

Save to
P:\Marina Tower\05 BIM\masterformat-keynotes.txtBrowse…
CancelCreate
The ? on the sheet

The tags that print as ? — found, named, and one click from fixed.

A card at the top lists every placed keynote tag with no key, and every tag showing a key the file no longer has. It says how many are on a sheet right now — those print as ? for the client — opens the view each one lives in, and bulk-deletes the ticked strays. The library itself is untouched; this is tag surgery, not file surgery.

New to Revit: the ? found before the client does.
BIMIO · Ledger — Keynote managerBIMIO
Keynote tags that print as ?7
3 with no key · 4 showing a key this file doesn't have · 2 of these are on a sheet right now — those print as ? for the client.
Select allSelect none3 of 7 selected · 2 on a sheetDelete 3 tags
Empty(no key)Level 02 — Detail at parapet · sheet A431Go to Level 02 — Detail at parapet
Not in fileM40/021Roof plan — Membrane upstand · sheet A502Go to Roof plan — Membrane upstand
Not in fileF30/112Level 05 — Core wall junctionGo to Level 05 — Core wall junction
The whole health check

One button asks whether the library and the model still agree.

Audit grades the whole library in three tones. Red: tags showing a key the file lost, a parent that no longer exists, a hierarchy that loops back on itself, the same code entered twice. Amber: elements carrying a key nobody defined, and the fault a shared library really accumulates — two codes holding the identical sentence, which print the same on a sheet and cannot be told apart. Grey: the housekeeping totals. Copy report hands the findings to whoever owns the fix.

New to Revit: a keynote library that can be graded before issue, not just browsed — seven checks where Revit offers none.
BIMIO · LedgerBIMIO
Keynote audit
office-keynotes.txt against this model — orphan tags, dangling keys and library health.
3 errors · 3 warnings · 2 notes
ERRORM-22Parent 'M-20' does not exist.
ERRORC-081 placed tag shows 'C-08', but the library has no such key — it renders as ? on sheets.
ERRORP-143 placed tags show 'P-14', but the library has no such key — they render as ? on sheets.
WARNINGF-3112 elements carry the key 'F-31', which isn't in the library — tagging them would show ?.
WARNINGS-118 elements carry the key 'S-11', which isn't in the library — tagging them would show ?.
WARNINGW-042 keynotes share the same text “Painted plasterboard partition, 100 mm studs”: W-04, W-19 — they print identically, so a sheet cannot tell them apart.
NOTE142 keynote(s) are carried by elements but never tagged (amber dots).
NOTE841 of 1197 keynotes are unused in this model (grey dots — the pruning list).
Copy reportClose
Edit without fear

Change anything. Nothing is written until you say so.

New categories and keynotes, edits, deletes, drag onto another entry to re-parent — Tab and Shift+Tab do it from the keyboard. Every change is a draft: a banner flags them, Save to file writes the .txt once and reloads Revit's keynote table in the same gesture, Reload throws the drafts away. And Rename key… rewrites the model's tags and elements along with the key, so nothing is left pointing at a code that no longer exists.

New to Revit: keynote editing with a draft state and one deliberate save — not a live wire into the .txt.
BIMIO · Ledger — Keynote managerBIMIO
Ledger
1197 keynotes · 214 tagged · 356 used in this model.
● Unsaved changes — click “Save to file” to write the keynote .txt.
Save to fileNew categoryNew keynoteEditDeleteFrom selectionShow in modelRename key…Audit
Search the library by code or text…
ShowTaggedAssigned, not taggedUnusedIn this viewLockedMaster…Prune…HistoryReport
F30Masonry12 tags · 31 elems
F30/110Facing brickwork, stretcher bond
F30/115Blockwork, fair-faced — edited
F30/191New keynote — glazed special (draft)
Tagged — a keynote tag is placedAssigned — elements carry it, no tag yetUnused — not in this model
Someone got there first

Saving shows you what it would do to somebody else's rows.

Ledger remembers the exact text its library came from. When the .txt has moved on since — a colleague edited it on the share while your drive was down — Save to file refuses to overwrite. The same reconcile preview opens with the direction reversed and says so: “Someone edited office-keynotes.txt since Ledger loaded it. This is what saving your version would do to the file — rows shown as DELETE are theirs, not yours.” Nothing reaches the file until you commit.

New to Revit: a keynote save that cannot silently revert a colleague's work — the two rows you never saw are shown to you as deletions.
BIMIO · LedgerBIMIO
The keynote file changed while you were working
Someone edited office-keynotes.txt since Ledger loaded it. This is what saving your version would do to the file — rows shown as DELETE are theirs, not yours.
Show unchanged rows
1 add · 1 modify · 2 delete · 1195 unchanged
DELETER-07Single-ply membrane roof, mechanically fixed
DELETER-08Inverted warm roof, ballasted
ADDP-22Acoustic partition, 2 × 15 mm each side (under P-20)
MODIFYW-04text: “Painted plasterboard partition” → “Painted plasterboard partition, 100 mm studs”
CancelCommit 4 changes
Excel, round trip

Bulk edits belong in Excel — the review belongs here.

Export the library, renumber and rewrite it comfortably in Excel, and import it back: Ledger shows every add, change and delete before the file is touched. Broken rows block the commit; repaired ones are noted rather than refused; and deleting a keynote still shown by placed tags demands an explicit tick. Ledger also remembers every workbook it exported — Up to date, Library changed, Excel pending, Conflict or File missing.

New to Revit: a keynote import that shows its plan — instead of replacing the file and hoping.
BIMIO · LedgerBIMIO
Import & reconcile
office-keynotes.xlsx — nothing touches the keynote file until you commit.
Show unchanged rows
1 add · 1 modify · 1 delete (1 in use) · 1195 unchanged
ADDF30/191Glazed brick special (under F30)
MODIFYF30/115text: “Blockwork, fair-faced” → “Blockwork, fair-faced both sides”
DELETE · IN USEM40/021Roofing membrane upstand — 'M40/021' is used in this model (1 tag); deleting it leaves its tags and elements with a broken key.
I understand 1 placed keynote will be deleted — its tags keep showing a key the library no longer defines.
CancelCommit 3 changes
The office standard

Pull from the master. Never push to it.

Compare the project's library against the office master keynote file — read-only by construction, and the window says so. Tick what to bring in, with a warning wherever a pulled change rewrites text already placed on sheets, and a confirm gate before anything placed is rewritten. Prune reviews the never-used entries the same way.

New to Revit: an office keynote standard that flows one way — into projects, never out of them.
BIMIO · LedgerBIMIO
Compare with the office master
Marina Tower — Block A ← office-master-keynotes.txt
Hide identical
The master is only ever read. Nothing here can write to it — changes go one way, into this project. Keynotes that exist only in your project are listed for review and cannot be removed from here.
1 only in master · 2 text differs · 0 moved · 6 only yours · 1189 identical
Select allSelect none2 of 3 selected · 1 placed in the model
TEXT DIFFERSF30/110“Facing brickwork, stretcher bond” → “Facing brickwork, stretcher bond, recessed joint”
Placed in the model — this changes what prints on the sheets.
IN MASTER ONLYF30/120Engineering brickwork, Class B
TEXT DIFFERSM40/050“Ceramic floor tiling” → “Ceramic floor tiling, 300 × 300 mm”
I understand 1 of these is placed in the model, so its text changes on the sheets showing it.
CancelBring in 2 keynotes
Memory and proof

It remembers what changed — even what changed behind its back.

History shows every change committed through Ledger, and the net difference between any two days. Edits made to the .txt outside Ledger are detected against the copy the model keeps, and recorded too. That same copy keeps you working when the network drive is down — the save simply waits for the file to come back. And one button exports a self-contained HTML report: summary, integrity audit, recent changes and the full library with its dots, openable on any laptop without Revit.

New to Revit: a keynote library with a history and an audit — for a file format that has neither.
BIMIO · LedgerBIMIO
History
office-keynotes.txt — every change Ledger committed, newest first. Pick two days to see the net difference between them.
EDITEDF30/115Text changed2026-08-28 17:41 · fmartinez
ADDED · XLSXF30/191Added via Excel import2026-08-27 12:03 · fmartinez
EDITED · FILEM40/050Changed outside Ledger — detected on load2026-08-25 09:12 · outside Ledger
Close
Outside its own window

Every keynote answer is available wherever you click, not only here.

Click any element in Lens and its keynote code resolves to the sentence it prints, with its type and its parent. Click a keynote tag and Lens says outright whether it prints as ?. It reads Ledger's own store — the resolved library held for thirty seconds so a click stays instant, and dropped whenever the document changes — and classifies with the same rule the panel's list uses, so the two surfaces can never disagree about what counts as broken. The coordinator who never opens Ledger still sees the keynote truth on the element in front of them.

New to Revit: keynote answers on the element itself, inside another app's panel — read straight from Ledger's own store, with no model scan.
Lens×
ProjectElementType⤴ HTML
i
GENERAL INFO
Identity, placement and authorship.
Id4 812 336
LEDGEROpen ↗
This keynote tag prints as ? — read live from the model.
P-14Not in the project's keynote fileNOT IN FILE
See the real output

This is an actual HTML report Ledger exports — self-contained, works offline, shareable as one file. Scroll it right here, or open it full-screen.

Open full report

Stop editing keynotes in Notepad.

Ledger ships on the Data panel of the BIMIO tab. Open the library, see what's really used, and never let a ? reach a printed sheet again. Revit 2024–2027, full trial, no card.

← PreviousInlay