ScreenshotNeo

BlogHTML to image & PDF

How to Add Bookmarks or Outlines to PDF Documents

Learn how to add, organize, and automatically generate PDF bookmarks and outlines in Acrobat and Word, with troubleshooting and accessibility guidance.

By the ScreenshotNeo team1 October 20267 min read

PDF bookmarks are clickable navigation links displayed in a PDF reader’s Bookmarks panel. The formal PDF outline is the tree of outline objects behind those links. You can add bookmarks manually in Adobe Acrobat, create a nested hierarchy, or generate them from headings and other structure in Word or a tagged source document.

For a finished PDF, use Acrobat’s Bookmarks panel. If you still have the source document, apply heading styles first and export with bookmark and tagged-PDF options enabled; this is faster and more consistent for long documents.

1. Add a bookmark manually in Adobe Acrobat

  1. Open the PDF in Acrobat and select the Bookmarks icon in the navigation panel.
  2. Go to the page where the destination should open. Set the zoom level and scroll position exactly as you want readers to see it.
  3. Optionally use the Select tool to highlight text, or click and drag around an image or area when a more precise destination is useful.
  4. In the Bookmarks panel, choose New Bookmark.
  5. Type the bookmark label and press Enter. The label should describe the destination, such as “Installation” or “Appendix A”.
  6. Rename an existing entry from the Bookmarks panel’s Options menu when necessary.

Acrobat defines a bookmark as a link with representative text in the navigation pane. In the PDF data model, a bookmark corresponds to an outline object, and an outline is a tree-structured hierarchy of bookmarks. See Adobe’s Acrobat bookmarks documentation and the Acrobat SDK bookmark reference.

2. Build a nested outline

A hierarchy lets readers expand a chapter and reveal its sections. Creating it does not move or reorder the PDF pages; it changes the navigation tree.

  1. Create the top-level bookmarks first, such as “Chapter 1” and “Chapter 2”.
  2. Drag a section bookmark directly beneath its chapter bookmark until Acrobat shows the nesting indicator.
  3. Release it to make the section a child of that chapter.
  4. Drag entries up or down to change their order. Moving a bookmark changes its position in the tree, not the underlying page.
  5. Expand and collapse each top-level entry to check the final outline.

Keep hierarchy levels aligned with the document’s headings. A flat list is easier to create but becomes difficult to scan in a long report; excessive nesting makes the panel harder to use.

3. Generate bookmarks from a structured PDF

If the PDF contains usable structural elements, Acrobat can generate bookmarks from them:

  1. Open the structured PDF.
  2. Open the Bookmarks panel and choose New Bookmarks From Structure.
  3. Select the heading or structural element levels to include.
  4. Review the generated labels, destinations, order, and nesting. Correct any headings that were tagged incorrectly in the source.

This method depends on the document having real structure. A PDF that only looks like it has headings visually may not contain the tags Acrobat needs. The generated tree still requires review, especially after OCR, layout conversion, or merged documents.

4. Create bookmarks from Microsoft Word headings

When the editable source exists, the source-first workflow is usually the most reliable:

  1. Apply Word’s built-in Heading 1, Heading 2, and lower-level heading styles to the document structure.
  2. Use heading levels consistently. Do not format ordinary paragraphs to look like headings while leaving them tagged as body text.
  3. If you need links to specific non-heading locations, add Word bookmarks where those destinations belong.
  4. Export to PDF with options that retain headings or Word bookmarks as PDF bookmarks, and enable tagged PDF output when available.
  5. Open the result in Acrobat and inspect the Bookmarks panel. Check labels, page destinations, nesting, and collapsed or expanded states.

Microsoft documents preserving headings or Word bookmarks as PDF bookmarks in its Word PDF accessibility guidance. The W3C describes both converting a Word table of contents to bookmarks and adding bookmarks in Acrobat Pro after conversion in PDF2: Creating bookmarks in PDF documents. Export controls vary by Word and Acrobat version, so verify the current labels in your installation.

5. Choose the right workflow

Situation Recommended method Why
Finished PDF with no source Manual Acrobat bookmarks Works directly on the delivered file and gives precise destination control.
Long Word document with heading styles Export headings as bookmarks Generates a consistent hierarchy from the source structure.
Tagged, structured PDF New Bookmarks From Structure Uses existing structural elements instead of rebuilding the tree.
Accessibility-sensitive publication Tagged source plus reviewed bookmarks Combines structural semantics with visible navigation checks.
Merged files from several sources Manual review after merging Labels, levels, and destinations often need normalization.

6. Review destinations and accessibility

  • Destination view: Open every top-level bookmark and several child entries to confirm the intended page, zoom, and scroll position.
  • Labels: Use short, descriptive names. Avoid duplicate labels when readers need to distinguish sections.
  • Hierarchy: Ensure each child belongs under the correct parent and that heading levels do not skip unexpectedly.
  • Structure: Bookmarks help navigation but do not replace tags, reading order, heading semantics, or other accessibility work.
  • Security: PDF permissions can prevent bookmark creation or editing. Check the document’s security settings if New Bookmark is disabled; Adobe notes that permissions must allow editing.
  • Final validation: Test the file in more than one PDF reader when the document is widely distributed.

7. Troubleshooting common problems

Problem Likely cause Fix
New Bookmark is unavailable Security permissions prohibit editing. Inspect the PDF’s security settings and obtain an editable copy or the owner’s password.
Bookmark opens the wrong place The view was not set before creation, or the page layout changed later. Navigate to the correct page and view, then update or recreate the bookmark.
Bookmarks are all at one level Entries were created without nesting. Drag section entries beneath their parent until Acrobat shows the nesting indicator.
Automatic generation finds nothing The PDF has no usable heading or structure tags. Return to the source and apply heading styles, export a tagged PDF, or create bookmarks manually.
Word headings do not appear in the PDF outline Heading styles were not used, or export settings omitted bookmarks. Apply built-in heading styles and enable the current export option for headings or Word bookmarks.
Labels are incorrect after OCR or conversion Recognition or conversion changed the source text. Rename entries manually and inspect the hierarchy before publishing.
Bookmarks disappear after a later export The PDF was regenerated from the source without carrying the outline forward. Fix the source heading/bookmark structure and export again, or add bookmarks to the final PDF as the last production step.

8. Performance, reliability, and maintenance

Source-based generation scales better than manually creating hundreds of entries, but it is only as reliable as the heading structure. Manual bookmarks provide exact control for a small or final document. For a repeatable publishing pipeline, keep the source headings authoritative, export with tags and bookmarks enabled, then run a review checklist on the generated PDF.

  • Generate from the source after major content changes so page destinations stay current.
  • Use manual edits for exceptions, then record those exceptions in the source workflow if the PDF will be regenerated.
  • After merging or splitting PDFs, recheck parent-child relationships and destinations.
  • Keep a final PDF copy whose outline has been reviewed; do not assume a visually correct table of contents means the PDF outline is correct.

9. Or skip the browser setup

If you need a PDF or image capture as part of an automated document workflow, ScreenshotNeo provides a website screenshot API and MCP server. It can capture PDFs with paper size, margins, landscape mode, and page ranges, so you can produce the source PDF first and then add or review its outline in Acrobat.

See the ScreenshotNeo API documentation for the current options. A basic request is:

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp
import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"}, timeout=90)
open("shot.webp", "wb").write(r.content)
const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);

Cookie banners, newsletter popups, and chat widgets are removed before the shot. Bot checks, blank pages, failed loads, timeouts, and cache hits are never billed, and response headers identify the page verdict and billing status. The MCP server includes take_screenshot, get_page_info, and capture_pdf tools for Claude, Cursor, and other MCP clients. The Free plan includes 1,000 screenshots a month with no card; paid plans start at $5 for 3,000. Create a free ScreenshotNeo account.

10. FAQ

Are PDF bookmarks and outlines different?

Bookmark is the user-facing navigation link. Outline is the underlying tree of outline objects that stores those links and their hierarchy.

Can I move a bookmark without moving a page?

Yes. Dragging a bookmark changes its order or parent in the navigation tree; it does not rearrange PDF pages.

Can I add bookmarks to a secured PDF?

Only if the document’s permissions allow the required editing operation. Otherwise obtain an editable copy or the owner’s password.

Should I make bookmarks flat or nested?

Use top-level entries for major sections and nest their subsections. Keep levels aligned with the document’s heading structure.

Do bookmarks make a PDF accessible by themselves?

No. They improve navigation, while accessibility also depends on tags, reading order, heading semantics, and other document properties.