How to Create a Table of Contents in PDF Documents

A complete guide to generating, formatting, and maintaining tables of contents in PDF files — using bookmarks, Acrobat plugins, and online tools.

← Back to Blog

What Is a PDF Table of Contents?

Quick answer: A PDF table of contents is a page (or set of pages) inserted into a PDF document that lists section headings with their corresponding page numbers, with each entry linked to the target page. You can create one from existing bookmarks using Mapsoft TOCBuilder for Adobe Acrobat, or generate a PDF table of contents online using Mapsoft's PDF Hub.

A table of contents (TOC) serves as a navigational roadmap for a document. In printed materials, it tells the reader which page to turn to. In a PDF, it does the same thing — but with the added benefit that each entry can be a clickable hyperlink, taking the reader directly to the referenced section.

Despite being one of the most basic features of any well-structured document, tables of contents are surprisingly absent from many PDFs. Documents that were scanned from paper, assembled from multiple source files, or exported from applications that do not generate TOCs automatically often arrive as undifferentiated blocks of content with no navigation structure at all.

This guide covers every practical method for adding a table of contents to a PDF, from manual approaches to fully automated generation using Acrobat plugins and online tools.

Why a Table of Contents Matters

A well-structured TOC improves a PDF document in several important ways:

  • Navigation — Readers can jump directly to the section they need rather than scrolling through dozens or hundreds of pages. In long documents such as technical manuals, annual reports, or legal contracts, this saves significant time.
  • Professionalism — A formatted TOC signals that the document has been prepared with care. It is expected in formal publications, tender submissions, regulatory filings, and corporate reports.
  • Accessibility — For users of assistive technologies, a TOC provides an alternative navigation mechanism alongside bookmarks and tagged structure. Screen readers can present the TOC as a list of links, allowing users to navigate to specific sections without relying on visual scanning.
  • Compliance — Some regulatory and procurement requirements explicitly mandate a table of contents in submitted documents. Government tender specifications, for example, often require a TOC as part of the document structure.
  • Print utility — Even when a PDF is printed, the TOC page retains its value as a physical reference, listing sections and page numbers in a format familiar to any reader.

The Relationship Between Bookmarks and a TOC

PDF bookmarks and a table of contents page serve related but distinct purposes. Understanding the difference is important because they are often confused:

  • Bookmarks are a navigation panel built into the PDF viewer. They appear in a collapsible tree in the left-hand panel of Adobe Acrobat or Reader. Bookmarks are metadata — they are not visible on the printed page.
  • A TOC page is a visible page within the document itself. It lists section titles and page numbers and is part of the document's printed content.

In an ideal document, both exist: bookmarks for on-screen navigation via the viewer panel, and a TOC page for printed copies and for readers who prefer in-document navigation. The most efficient workflow is to create bookmarks first and then generate the TOC page from those bookmarks automatically.

Method 1: Generate a TOC from Bookmarks Using TOCBuilder

Mapsoft TOCBuilder is an Adobe Acrobat plugin purpose-built for generating table of contents pages from a PDF's existing bookmark tree. It produces a professionally formatted TOC page with clickable links, dot leaders, page numbers, and hierarchical indentation — all configurable.

How TOCBuilder Works

  1. Install the plugin — Download and install TOCBuilder from the Mapsoft product page. It integrates directly into Adobe Acrobat Pro as a menu item and toolbar button.
  2. Open your PDF — The document must have bookmarks. If it does not, create them first (see methods below).
  3. Open the TOCBuilder dialog — Access it from the Acrobat Plugins menu or toolbar. The dialog presents all formatting options.
  4. Configure formatting — Set the font family, font size, line spacing, indentation per bookmark level, dot leader style, page number alignment, and header text (e.g. "Table of Contents" or "Contents").
  5. Select bookmark levels — Choose how many levels of the bookmark hierarchy to include. For a concise TOC, you might include only the top two levels. For a detailed TOC, include all levels.
  6. Generate — Click Generate. TOCBuilder reads the bookmark tree, resolves each bookmark's target page number, and inserts one or more formatted TOC pages at the beginning of the document. Each entry is a clickable link action that navigates to the corresponding page.

TOCBuilder Formatting Options

TOCBuilder provides granular control over the appearance of the generated TOC:

  • Font and size — Choose any font available on the system. Different font sizes can be assigned to different bookmark levels (e.g. 14 pt for level 1, 12 pt for level 2, 10 pt for level 3).
  • Indentation — Set the left margin offset for each level of the hierarchy, creating a clear visual structure.
  • Dot leaders — The dotted line connecting the section title to its page number. TOCBuilder supports solid dots, dashes, or no leader at all.
  • Page numbers — Display as Arabic numerals, Roman numerals, or use the document's page labels if they have been set.
  • Header — Customise the text that appears at the top of the TOC page (e.g. "Contents", "Table of Contents", or any text you prefer).
  • Page size and margins — The TOC page can match the document's existing page size or use a custom size.

Method 2: Generate a TOC Online

If you do not have Adobe Acrobat or prefer not to install plugins, you can generate a PDF table of contents online using Mapsoft's PDF Hub. Upload your PDF (which must contain bookmarks), configure the formatting options, and download the result with a TOC page inserted. This is a free tool that requires no registration.

Method 3: Create Bookmarks First, Then Generate the TOC

If your PDF has no bookmarks, you need to create them before a TOC can be generated automatically. There are several approaches:

Manual Bookmark Creation in Acrobat

  1. Open the PDF in Adobe Acrobat Pro.
  2. Open the Bookmarks panel (click the bookmark icon in the left navigation pane, or go to View > Show/Hide > Navigation Panes > Bookmarks).
  3. Navigate to the first section heading in the document.
  4. Select the heading text on the page (optional — if you select text, Acrobat will use it as the bookmark name).
  5. Press Ctrl+B (Windows) or Cmd+B (Mac) to create a new bookmark. Alternatively, right-click in the Bookmarks panel and select Add Bookmark.
  6. The bookmark is created pointing to the current page view. Rename it if needed by clicking on the bookmark text.
  7. To create a hierarchy, drag bookmarks to nest them under parent entries.
  8. Repeat for each section heading in the document.

This method works well for short documents but becomes tedious for PDFs with dozens or hundreds of sections.

Automatic Bookmark Generation from Structure

If the PDF was created from a source application that preserved heading structure (such as Microsoft Word with Heading 1, Heading 2, etc., or InDesign with paragraph styles mapped to PDF bookmarks), Acrobat can use that structure to generate bookmarks automatically:

  • If the PDF has tagged structure, go to View > Show/Hide > Navigation Panes > Tags to see the tag tree. Heading tags (H1, H2, H3, etc.) can be used as the basis for bookmarks.
  • Use Mapsoft Bookmarker to generate bookmarks from text patterns, font attributes, or tag structure — a far more powerful approach than manual creation for large documents.

Bookmark Generation from Text Patterns

For PDFs where section headings follow a consistent pattern (e.g. numbered sections like "1.0 Introduction", "2.0 Methodology", or headings in a specific font and size), Mapsoft Bookmarker can scan the document and create bookmarks automatically by matching those patterns. This is particularly valuable for scanned documents that have been OCR-processed, where the original document structure has been lost.

Method 4: Manual TOC Creation

If automated generation is not an option, you can create a TOC page manually. This is labour-intensive but sometimes necessary for documents with specific formatting requirements that no automated tool can replicate.

  1. Create the TOC content in a word processor or design application (Word, InDesign, or even a text editor).
  2. Export it as a single-page PDF.
  3. Insert the TOC page into the target document using Tools > Organize Pages > Insert in Adobe Acrobat.
  4. Manually add link annotations to each TOC entry: select the Edit PDF tool, then Link > Add/Edit Web or Document Link. Draw a rectangle over each TOC entry and set the link action to "Go to a page view", then navigate to the target page and click "Set Link".

This method gives you complete visual control but requires manual maintenance — if the document changes and page numbers shift, you must update the TOC page and all its links manually.

Method 5: TOC Generation via Acrobat JavaScript

For developers and automation specialists, Acrobat JavaScript can be used to read the bookmark tree programmatically and generate a TOC page. The approach involves:

  1. Traversing the bookmarkRoot object to enumerate all bookmarks and their target pages.
  2. Creating a new page at the beginning of the document using this.newPage().
  3. Adding text fields or annotations to the new page to render the TOC content.
  4. Attaching GoTo page actions to each text element or annotation.

This approach is powerful but requires significant JavaScript expertise and careful handling of page coordinate systems, font metrics, and link actions. For most users, TOCBuilder provides the same result without writing code.

Formatting Considerations

A well-formatted TOC follows established typographic conventions that make it easy to scan and use:

  • Hierarchy — Use indentation and font size variation to distinguish between levels. First-level headings should be visually prominent; sub-headings should be indented and may use a smaller or lighter font.
  • Dot leaders — The dotted line between the section title and page number guides the eye across the page. This is a long-established typographic convention and should be used unless the design specifically calls for a different approach.
  • Page numbers — Right-align page numbers for easy scanning. If the document uses page labels (e.g. Roman numerals for front matter, Arabic numerals for body content), the TOC should reflect those labels rather than physical page numbers.
  • Clickable links — In a PDF viewed on screen, every TOC entry should be a clickable link. This is handled automatically by TOCBuilder and by the online PDF Hub tool.
  • Consistency — The TOC should use the same terminology as the document headings. If a section is titled "3.0 Risk Assessment" in the document, the TOC entry should read exactly the same.

Updating a TOC After Document Changes

Documents change. Pages are added, removed, or reordered. Section headings are renamed. When this happens, the TOC becomes stale — page numbers no longer match, and links may point to the wrong locations.

  • With TOCBuilder — Simply delete the existing TOC pages, update the bookmarks if needed, and regenerate. TOCBuilder reads the current bookmark tree and current page numbers each time it runs.
  • With the online tool — Upload the updated document to Mapsoft PDF Hub and regenerate.
  • Manually — You must manually verify and update every page number and link action. This is error-prone and time-consuming for large documents.

The ease of regeneration is one of the strongest arguments for using an automated tool rather than manual TOC creation.

Page Labels and the TOC

Many professional documents use page labels — Roman numerals (i, ii, iii) for the front matter, Arabic numerals (1, 2, 3) for the body, and sometimes letter prefixes (A-1, A-2) for appendices. A good TOC respects these labels.

TOCBuilder supports page labels: if the document has page labels defined (via Tools > Organize Pages > Page Labels in Acrobat), the generated TOC will display those labels rather than the underlying physical page numbers. This is essential for documents like annual reports, regulatory submissions, and technical manuals where front matter numbering differs from body numbering.

For more information on page labels, see our guide to PDF page labels.

TOC and PDF Accessibility

For documents that need to meet accessibility standards (WCAG 2.1, PDF/UA, Section 508), the TOC page should be properly tagged in the document's tag tree. Each TOC entry should be tagged as a link (<Link>) containing a <Reference> element, and the TOC section itself should be tagged with a <TOC> and <TOCI> (Table of Contents Item) structure.

TOCBuilder generates tagged content when the option is enabled, ensuring that the TOC page contributes to rather than detracts from the document's accessibility compliance.

Batch TOC Generation

Organisations that produce large numbers of documents — report series, manual sets, regulatory filings — often need to add TOC pages to many PDFs at once. TOCBuilder supports batch processing through Acrobat's Action Wizard, allowing you to apply the same TOC configuration to an entire folder of documents in a single operation.

Related Articles

Table of Contents Guide

A comprehensive reference on table of contents creation in PDF documents — covering structure, formatting conventions, and tools for generating TOC pages.

PDF Bookmarks: A Complete Guide

Everything you need to know about PDF bookmarks — creating, editing, organising, and automating bookmark trees in Adobe Acrobat.

PDF Page Labels

How to set and manage page labels in PDF documents — Roman numerals, custom prefixes, and multi-section numbering schemes.

Generate a Table of Contents for Your PDF

Use Mapsoft TOCBuilder to create professional, clickable tables of contents from your PDF bookmarks — or try the free online tool.