MainspringGuides › Paths for documentation
macOS Guide

Show the folder path in Finder for documentation

Updated August 2026 · 3 min read

When you're writing a README, a support article, or a step-by-step tutorial, "put the file in your Application Support folder" isn't good enough — a reader needs the exact path, spelled correctly. Turning on the full path in Finder's title bar means the canonical location is always on screen while you write, so you transcribe /Users/you/Library/Application Support/AppName instead of guessing at it. It's a one-line Terminal change and it undoes cleanly.

Put the canonical path on screen

Open Terminal and run:

# Show the full POSIX path in Finder title bars
defaults write com.apple.finder _FXShowPosixPathInTitle -bool true
killall Finder

Every Finder window now titles itself with its absolute path, written the exact way the file system stores it — forward slashes, real capitalisation, spaces intact. That's the form you want in documentation, because it's copy-paste-safe into Terminal and unambiguous to a reader on a different Mac. When the doc is finished, restore the plain folder name:

# Undo
defaults write com.apple.finder _FXShowPosixPathInTitle -bool false
killall Finder

There's no System Settings toggle for this — it's a hidden Finder preference — and it behaves the same on macOS 13 Ventura, 14 Sonoma, and 15 Sequoia.

Copy the exact path, don't retype it

Reading a path off the title bar catches mistakes, but for anything long you'll want to copy it verbatim so a stray typo never reaches your reader:

  1. In Finder, right-click the folder (or file) you're documenting.
  2. Hold Option. The Copy item changes to Copy "name" as Pathname.
  3. Release on that item — the full POSIX path is now on your clipboard, ready to paste into your doc.

This is the safest way to get a path into prose or a code block, because it's the system's own string, not your transcription of it.

Format the path so it survives a copy-paste

How you present a path in a doc decides whether a reader can actually use it. A few rules keep them working:

Getting these right is exactly why having the real path on screen matters — you're transcribing a verified string and formatting it, not reconstructing it from memory.

Two conventions to keep your docs honest

With the full path visible and Copy as Pathname a right-click away, every location you reference is one you've verified on screen rather than remembered — which is the difference between a tutorial that works and one that generates support tickets.

Flip it on while you write

The full-path title bar is a Terminal-only preference with no Settings switch. Mainspring makes it a labelled toggle you can turn on for a writing session and off afterward — one of 90+ hidden macOS settings it exposes as reversible switches.

Try Mainspring free →

Signed & notarized by Apple · 1-day free trial · $29 once

Screenshots for the same doc

Docs usually pair a path with a picture. When you grab those, a lighter file format keeps the page fast — see how to save Mac screenshots as JPG to shrink them before they go into your tutorial.