Skip to main content
PDFBase

Add Bookmarks to PDF

Local

Add navigation bookmarks to PDF documents

All Tools
Add Bookmarks
Local
Tool Details
Input formatsPDF
Output formatPDF
Max file size100 MB
Max files1
ProcessingLocal
Related Tools

Edit Metadata

Set standard PDF metadata fields such as title and author

Merge PDF

Combine multiple PDF files into one document

Privacy First

Your files are processed entirely in your browser. Nothing is uploaded to any server.

How do I add bookmarks to a PDF?

Load the PDF and enter one bookmark per line as a page number and a title, for example 1: Introduction. The tool writes a standard PDF outline, so the entries appear in the navigation sidebar of Acrobat, Preview, and other viewers and jump straight to their pages. The document is rewritten in your browser and never uploaded.

About the Add Bookmarks to PDF

Add clickable bookmarks (a table of contents) to PDF documents for easy navigation. Enter one bookmark per line with a page number and title, and the tool writes a standard PDF outline that appears in the sidebar of Adobe Acrobat, Preview, and other PDF viewers.

  • Give a long report, manual or thesis a working sidebar outline so readers can jump to a chapter instead of scrolling.
  • Add navigation to a PDF produced by a tool that never wrote an outline, such as a scanner, a print-to-PDF driver or a merge of separate files.
  • Write the whole table of contents in one pass by pasting lines in page: title form rather than clicking through a bookmark panel.
  • Produce a standard PDF outline that shows up in Acrobat, Preview, Chrome and mobile readers alike.

How to use the Add Bookmarks tool

  1. 1

    Upload PDF file

    Select PDF file from your device or drag file into the upload area.

  2. 2

    Choose settings

    Choose settings such as Bookmarks before processing.

  3. 3

    Add Bookmarks

    Run the Add Bookmarks tool to create the PDF output.

  4. 4

    Download the result

    Download the finished file. The original file stays on your device and is not uploaded.

What format should each bookmark line use?

A page number, a separator, then the title — one entry per line. A colon, a hyphen, or a pipe all work as the separator, so 12: Methodology, 12 - Methodology, and 12 | Methodology are equivalent. Lines that do not start with a page number are skipped rather than guessed at, which means you can paste a rough table of contents and only the well-formed lines are used. Keep titles short enough to read in a narrow sidebar without truncation.

Are these the same as links inside the document?

No. A bookmark is an entry in the PDF outline, a separate navigation structure that viewers show in a sidebar panel, and it exists independently of anything printed on the page. A link is part of the page content and only works when someone finds and clicks it. Bookmarks are what make a long document navigable: the reader can see its structure and jump between sections without scrolling or knowing the page numbers.

Which documents benefit most from an outline?

Anything long enough that scrolling becomes the main way people interact with it — reports, manuals, contracts with numbered schedules, scanned bundles, course material, board packs. It is especially valuable for merged PDFs, where the constituent documents lose their identity the moment they are combined: adding one bookmark per source file restores the structure and turns a two-hundred-page blob back into something a reader can navigate deliberately.

Are my files uploaded when adding bookmarks to a PDF?

No. Bookmarks are added by rewriting the document’s outline structure in memory, in your browser. The documents that need an outline are typically long internal or client-facing bundles, and there is no reason to hand one to a hosted service just to gain a sidebar — so the file is read from disk, modified locally, and downloaded again.

How to do this offline, on the command line

qpdf can read and write the outline as JSON, which makes bookmarking scriptable.

qpdf

macOS: brew install qpdf · Debian/Ubuntu: apt install qpdf

qpdf --json=latest --json-key=outlines manual.pdf

Dumps the existing outline so you can see what is already there before adding to it.

pdftk (or pdftk-java)

macOS: brew install pdftk-java · Debian/Ubuntu: apt install pdftk-java

pdftk manual.pdf update_info bookmarks.txt output manual-bookmarked.pdf

bookmarks.txt uses BookmarkTitle / BookmarkLevel / BookmarkPageNumber triples, which pdftk dump_data will show you the format of.

Frequently Asked Questions

How do I define the bookmarks?
Type one bookmark per line in the format "page: title" — for example, "1: Introduction" and "12: Chapter 2". The tool validates page numbers against the document and writes a standard PDF outline.
Where do the bookmarks appear?
In the bookmarks or table-of-contents sidebar of PDF viewers such as Adobe Acrobat, macOS Preview, and browser PDF readers. The output is also set to open with the bookmark panel visible.
Can I add bookmarks to any PDF?
Yes, as long as the PDF is not password-protected. Existing bookmarks are replaced by the list you provide, so include every entry you want in the final document.
Why add bookmarks to a PDF?
Long documents — reports, manuals, dissertations, merged files — are far easier to navigate with a clickable outline. It is also a common requirement for accessibility and for document submission standards.

Need More Tools?

Explore our collection of 58 free PDF tools, all with privacy-first processing.

Browse All Tools