PDF Bookmarks: A Complete Guide

← Back to Blog

What Are PDF Bookmarks?

PDF bookmarks — sometimes called outline items — are a navigational aid embedded within a PDF document. They appear in the Bookmarks panel (the ribbon icon in Acrobat's navigation pane) as a hierarchical tree of clickable labels, each linked to a specific location or action within the document. When a reader clicks a bookmark, Acrobat scrolls to the associated page and zoom level, or executes the associated action.

Bookmarks are especially valuable in lengthy documents such as technical manuals, legal submissions, regulatory filings, and academic reports. Rather than scrolling through hundreds of pages, a reader can jump instantly to any section. For accessibility, bookmarks also help users of screen readers and assistive technology navigate document structure without relying on visual layout alone.

Despite their apparent simplicity, PDF bookmarks have a rich internal structure defined by the PDF specification and support a variety of link types, display styles, and nested hierarchies.

How Bookmarks Are Stored in the PDF Specification

The PDF specification — currently ISO 32000-2:2020 (PDF 2.0), and previously ISO 32000-1:2008 (PDF 1.7) — defines bookmarks as part of the document's outline. The outline is referenced from the document catalog using the /Outlines key:

1 0 obj
<< /Type /Catalog
   /Pages 2 0 R
   /Outlines 3 0 R
>>
endobj

The outline dictionary referenced by /Outlines is an outline object with /First and /Last keys pointing to the first and last top-level outline items. Each outline item is itself a dictionary containing:

• /Title — a text string shown to the user
• /Parent — reference to the parent outline item or the outline dictionary
• /Prev and /Next — siblings in the doubly-linked list
• /First and /Last — first and last children (for items with sub-bookmarks)
• /Count — the number of visible descendants (positive if the item is open, negative if closed)
• /Dest or /A — the destination or action to execute when clicked
• /C — optional colour for the bookmark label (an array of three 0–1 RGB values)
• /F — optional style flags (1 = italic, 2 = bold)

This linked-list structure allows arbitrary nesting and ensures that PDF viewers can traverse the tree efficiently without loading all bookmarks at once.

Types of Bookmarks

Destination Bookmarks

The most common type. The /Dest key specifies a page, a zoom type, and optionally coordinates. For example, a destination that opens page 5 at fit-width zoom is represented as:

[5 0 R /FitH 800]

Standard destination types include /XYZ (specific x, y, zoom), /Fit (fit the whole page), /FitH (fit width), /FitV (fit height), /FitR (fit a rectangle), /FitB, /FitBH, and /FitBV.

Action Bookmarks

Instead of a destination, the /A key can specify an action dictionary. This enables bookmarks that open URLs, execute JavaScript, submit forms, play media, or perform any other PDF action. For instance, a bookmark that opens an external website would use a /URI action, while one that runs a calculation might use a /JavaScript action.

Named Destinations

Rather than embedding a destination directly, a bookmark can reference a named destination — a symbolic name stored in the document's /Dests name tree or the /Names dictionary. Named destinations allow bookmarks to remain valid even if pages are rearranged, because the name is resolved at runtime rather than being a hard-coded page reference. They also enable cross-document linking.

How Acrobat Generates Bookmarks Automatically

When converting a Word document, InDesign file, or other structured source to PDF using Adobe's tools, Acrobat can automatically generate bookmarks based on paragraph styles. In Microsoft Word, headings styled with the built-in Heading 1, Heading 2, Heading 3 (and so on) styles are mapped to bookmark levels during export. In the Acrobat PDFMaker add-in (accessed via the Acrobat ribbon in Word), the Settings dialog lets you choose which styles become bookmarks and at which hierarchy level.

Adobe InDesign similarly maps paragraph styles to PDF bookmarks during export. In the Export Adobe PDF dialog, the Bookmarks checkbox in the General tab enables this, and the Structure pane controls the mapping between styles and bookmark levels.

When creating PDFs from the Acrobat print driver or Distiller, bookmarks are not generated automatically unless the source application supports PDFMaker integration or embeds structural information.

Creating and Editing Bookmarks Manually in Acrobat

In Adobe Acrobat Pro, you can create and manage bookmarks entirely by hand:

1. Open the Bookmarks panel from the left-hand navigation pane.
2. Navigate to the page and view you want the bookmark to target.
3. Click the New Bookmark icon (the page-with-ribbon icon at the top of the panel) or use Ctrl+B (Windows) / Cmd+B (Mac).
4. Type the bookmark label and press Enter.
5. To nest a bookmark, drag it onto a parent bookmark, or use the indent/outdent buttons.

Editing an existing bookmark's destination is done by right-clicking it and choosing Set Destination after navigating to the new target location. You can also rename bookmarks, change their text colour and style (bold/italic), and delete or reorder them via right-click context menus.

For documents with thousands of sections, however, manual bookmark creation is impractical. This is where automation tools become essential.

Bookmarks vs Page Labels vs Thumbnails

These three features are sometimes confused because they all assist navigation, but they serve different purposes:

• Bookmarks are hierarchical named links to destinations. They reflect the logical structure of the document (chapters, sections, subsections) and are explicitly authored or generated from style-based structure.
• Page labels (defined in the /PageLabels number tree) assign human-readable names to pages — such as roman numerals for a preface or section-prefixed numbers like "A-1, A-2" for appendices. They affect how Acrobat displays page numbers but do not create navigational links.
• Thumbnails are small rasterised previews of each page, stored as embedded image streams. They provide visual navigation but carry no semantic hierarchy and significantly increase file size, so modern viewers generate them dynamically rather than embedding them.

For the best reader experience in a long document, all three features complement each other: bookmarks provide structural navigation, page labels provide meaningful page identity, and thumbnails offer a visual overview.

Bookmarks and PDF Accessibility

For tagged PDFs targeting accessibility standards such as PDF/UA (ISO 14289) and WCAG 2.1, bookmarks are mandatory in documents exceeding a certain length. The PDF/UA standard requires that all documents with 21 or more pages include a document outline (bookmarks) that reflects the logical reading order of the document. Screen readers and other assistive technologies use the bookmark tree to allow users to jump between sections without having to navigate sequentially through every page.

When combined with tagged PDF structure (the /StructTreeRoot and associated tags), bookmarks tied to named destinations that resolve to specific tagged elements provide the most robust accessibility experience.

FDA Submission Requirements for Bookmarks

Regulatory submissions to the US Food and Drug Administration (FDA) have strict requirements for PDF bookmarks in electronic submissions via the eCTD (electronic Common Technical Document) format. The FDA's technical specifications require that all PDF documents be navigable via bookmarks, that bookmarks correspond to the document's table of contents, and that they be consistent with the filing's XML backbone.

For pharmaceutical and medical device companies submitting regulatory dossiers, correctly structured bookmarks are not optional — missing or malformed bookmarks can result in submission rejection. See our dedicated article on FDA PDF Compliance for full guidance on meeting these requirements.

Automated Bookmark Creation with Mapsoft Bookmarker

For organisations producing large volumes of documents — regulatory submissions, technical documentation, annual reports — manually managing bookmarks in Acrobat is time-consuming and error-prone. The Mapsoft Bookmarker plugin for Adobe Acrobat automates the entire process.

Bookmarker can generate a full bookmark tree from a document's structure, table of contents, or a user-defined configuration. It supports:

• Automatic detection of heading levels from text formatting (font size, style, colour)
• Generation from an existing table of contents page
• Batch processing of multiple documents in a single operation
• Customisable bookmark styles — colour and bold/italic flags per heading level
• Named destination support for robust cross-document linking
• Compliance checking against FDA eCTD and other regulatory standards

By automating bookmark creation, Bookmarker eliminates human error, reduces preparation time from hours to seconds, and ensures consistent, specification-compliant output across an entire document set.