All chapters
Getting started
Daily work
Find and understand
Research and publish
Protect your notes
Reference
The Note Inspector & history
The Note Inspector is a panel on the right of the editor that shows everything about the note you have open: its properties, its headings and links, the files it embeds, the sources it cites, and every saved version of it.
Opening the Inspector
With a note open, click the Show Note Inspector button at the right end of the toolbar (the icon of a window with a right-hand panel). Click it again, press Esc, or use the close button in the panel's header to put it away.
Other ways in, each landing on a particular tab:
- ⋯ → Note Properties opens Properties.
- ⋯ → Sources & Files → Attachments opens Navigator; ⋯ → Sources & Files → References opens References (only when the note cites something).
- Press ⌘K and run History to open the note's timeline.
The Inspector has four tabs: Properties, Navigator, History and References. It reopens on the tab you used last, and it stays open as you move between notes. Opening it closes the Assistant panel if that's open, since both use the right side of the window. Above the tabs, a small line gives the note's length, such as "1,240 words · 6 min read".
Properties
Properties are the key: value lines in a block between --- markers at the top of a Markdown file, often called frontmatter. Other Markdown apps read the same block. The Properties tab shows the ones your note has and lets you change them:
- Type and Status have a Change button with a list to pick from (types such as note, meeting, project, decision; statuses such as draft, active, evergreen, archived), or Custom... for your own word.
- Tags has an Edit button. Add a tag in the field, click a tag to remove it, or pick from the suggestions.
- Owner, Project and Summary are plain text boxes.
- Created, Updated and Path are shown for reference. Created and Updated come from the properties if the note has them, otherwise from the file.
- Anything else is under Custom fields. Header picks a control from the value: a date gets a calendar,
true/falsegets a checkbox, and so on. Hover a field and click the minus button to remove it.
To add one, open Add property. Click a suggestion such as Project or Owner, or type a Property name and Value and click Add. Names must be plain YAML keys, such as project or source_url. If the note has no frontmatter yet, Header creates the block. Clearing a value removes that line.
At the bottom are Copy note link, Reveal in Finder and Open in Source, which shows the raw Markdown, frontmatter included.
status: active between two --- lines.References
If you cite sources from your Research library, the References tab lists them with author and year. Click one to jump to where it's cited, or right-click for Jump to citation, Open PDF and Reveal PDF in Finder. A citation Header can't match shows as @key with a Resolve… button. Two buttons sit at the bottom: Export cited…, which exports just the sources this note cites, and Research library. Citations themselves are covered in Research & the Reading Room.
History (Time Travel) Safety
Header keeps a timeline of each note, which it also calls Time Travel. Open the History tab to see the Versions list, newest first. Each entry says what happened and when ("Edited", "Before AI change", "Renamed · backlinks updated", "Before delete" and so on), and changes made by AI carry an AI label.
Select a version and view it three ways: Rich shows it formatted, Markdown shows the plain text, and Changes compares it with the version before. Then:
- Copy version copies that version's full text, so you can paste back one paragraph without replacing the whole note.
- Restore puts that version in the editor. There's no confirmation step. Header first saves your current text as a version called "Before restoring a version". If it can't save that, it cancels the restore and leaves your text alone. The restored parts are highlighted in the note.
What makes a version
- Saving, including autosave a couple of seconds after you stop typing. While you keep editing, a save within three minutes of the last one updates the same "Edited" version instead of adding a new one, and saves that change nothing are skipped.
- The first time you open an existing note, Header records it as "Original".
- Before and after an AI change you apply, such as a Review or Refactor edit.
- Renaming (the history moves with the note), adding an image, restoring, and deleting: "Before delete" is kept even after the note goes to the Trash.
- Reloading from disk over your unsaved edits keeps "Your edits before reload", and settling a sync conflict keeps both sides.
- Changes made through Siri or Shortcuts, quick captures, web clips and new daily notes.
How long versions last
Ordinary "Edited" versions are kept for 30 days, up to 50 per note. Milestones, meaning everything else in the list above, have no time limit but are capped at 400 per note, and the oldest "Created" version always stays. Each note's history is limited to about 25 MB, and the newest milestone and the newest "Edited" version are always kept.
Where it's stored
Versions are plain Markdown copies plus a small index file, kept on your Mac or in your vault. Header doesn't upload them on its own. If you turn on Git backup, the .header/history folder is committed and pushed along with your notes. Where they go depends on Settings → Sync & Backup → History & local sync → Sync note history across your devices:
- On (the default): inside the vault, in a hidden
.header/historyfolder. If the vault syncs, through iCloud Drive for example, the history goes with it. See Sync & backup. - Off: in Header's own folder in
~/Library/Application Support, on this Mac only.