A 200-page PDF without bookmarks is unreadable on any device. The outline panel is the difference between "I'll skim later" and "I'll actually use this." Bookmarks take minutes to add and make documents feel instantly professional.
Outline Structure
| Outline Element | Holds | Notes |
|---|---|---|
| Title | Display label | Plain text, supports any Unicode |
| Destination | Page + view | Explicit or named destination |
| Parent / Child links | Tree position | Enables nesting up to many levels |
| Next / Prev | Siblings | Defines display order |
| Color & style | Optional visual cues | Bold/italic for top-level chapters |
| Action | Optional richer behaviour | JavaScript, URI — use sparingly |
Manual vs Programmatic Bookmarks
For short documents, adding bookmarks manually in a PDF editor is fastest. Open the outline panel, select a target page, and add a top-level or nested entry. For long, frequently regenerated documents (reports, books, exports from a CMS), generate the outline programmatically. Tools like pdf-lib (JS), PyMuPDF (Python), and iText (Java) can walk the structure tree, find heading tags, and write outline entries in one pass.
Good Bookmark Hygiene
- Mirror the visible heading hierarchy — H1 = top level, H2 = child, etc.
- Keep labels under ~60 characters; long titles wrap and look messy.
- Use named destinations for chapter starts; raw page numbers break when pages are added or removed.
- Set the document's
PageModetoUseOutlinesso the panel opens automatically. - Test on mobile readers — some flatten nesting beyond two levels.
Common Problems
- All bookmarks point to page 1: happens when destinations were never set during export. Re-export with bookmarks enabled.
- Outline panel hidden by default: set
PageMode = UseOutlinesin the catalog. - Wrong zoom on click: use the Fit or FitH (fit width) destination type, not XYZ which preserves the author's zoom level.
- Broken after merge: use a merge tool that preserves outlines and re-targets pages.
Combine Sectioned PDFs
Merge chapter PDFs into a single book — bookmarks and order preserved.
Merge PDF →