All chapters
  1. Getting started

    1. Start here
    2. Install, update & first launch
    3. Bring your notes in
    4. Your vault & the window
  2. Daily work

    1. Writing & the editor
    2. The Note Inspector & history
    3. Capturing ideas
    4. Today & daily notes
    5. Tasks
    6. Minutes: recording meetings
  3. Find and understand

    1. Finding & connecting notes
    2. Setting up AI
    3. Ask Header
    4. AI writing tools: Review, Refactor & the selection assistant
    5. Lenses
    6. Atlas
    7. Mindprint, Review & Retro
  4. Research and publish

    1. Research & the Reading Room
    2. Manuscripts
    3. Boards
  5. Protect your notes

    1. Trust, safety & privacy
    2. Sync & backup
  6. Reference

    1. Header across macOS
    2. Settings
    3. Keyboard shortcuts
    4. Help, feedback & FAQ
Inside a note

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

Closed until you ask for it

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".

Find it toolbar → Show Note Inspector · ⌘K → History

Properties

The note's frontmatter, without typing YAML

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/false gets 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.

A properties bar above the note: Header can also show properties as a row of chips above the text. It's off by default. Turn it on in Settings → Editor → Editor controls → Show note properties, choosing When the note has properties or Always. The bar doesn't appear in Source mode or Focus Mode.
Try this Open a note called Client kickoff, click Add property, choose Status, then pick active. Now choose Open in Source: the top of the file reads status: active between two --- lines.

Navigator: outline, links and attachments

Move around a long note, and see what connects to it

The Navigator tab has three sections, Outline, Links and Attachments. Each folds away, and Header remembers which you keep open.

Outline lists the note's headings, indented by level, with the one you're in highlighted. Click a heading to jump to it. The arrows beside a heading fold its sub-headings in the outline only; the note itself doesn't change. With no headings you'll see "No headings yet".

  • Backlinks: notes that link to this one with [[…]].
  • Outgoing links: notes this one links to.
  • Unlinked mentions: notes that contain this note's title as plain words but don't link to it, each with the line where it appears. The match ignores capitals but needs whole words, and titles shorter than three characters are skipped.

Click any entry to open that note, or the board, if the link comes from a board. Unlinked mentions are a reading list, not a fixer: to turn one into a link, open that note and add the [[link]] yourself.

Attachments lists the files the note embeds, such as ![[floor-plan.pdf]] or a local image. Click one to open it in its usual app, or right-click for Open and Reveal in Finder. A file that has gone missing shows an orange dashed icon.

Try this Open Japan Trip and look under Unlinked mentions. If Packing list says "sort out the Japan trip adapters" without a link, open it and wrap the words as [[Japan Trip]]. It moves to Backlinks.

References

The sources this note cites

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

Every saved version of the note, and a way back

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.

Properties Navigator History References Versions 4 Before AI change AI 10:42 AM Edited 10:15 AM Renamed · backlinks updated Yesterday Created Oct 2 Rich Markdown Changes + Budget: ¥310,000 for two weeks − Budget: about ¥250,000 Book the Kyoto ryokan by Friday Copy version Restore
Pick a version on the left. Changes shows what that version added (+) and removed (−) compared with the one before it.

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/history folder. 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.
Locked notes have no history. Locking a note deletes its saved versions, because they're unencrypted copies, and Header records no new ones while it's locked. History starts again when you unlock it. See Trust, safety & privacy.
Try this In a scratch note, type a paragraph, then drop any image into the note: Header records a "Before image added" version first. Now delete half the paragraph. Open History, select "Before image added", switch to Changes to see the missing lines, and click Restore. Your shorter draft is still in the list as "Before restoring a version". (Two plain edits a few seconds apart won't give you two versions: saves within three minutes fold into one "Edited" version, which is why the exercise uses the image.)
Find it Note Inspector → History · ⌘K → History