Validating PDF Bookmarks for Link and Formatting Issues

AutoBookmark for Adobe® Acrobat®

Ensuring Accurate and Consistent Bookmarks
In legal and healthcare environments, PDF documents can be subject to detailed requirements for bookmarks, navigation, and document structure. For example, court e-filing requirements can specify bookmark hierarchy, maximum bookmark length, and destination settings such as Inherit Zoom. In the healthcare and pharmaceutical sector, FDA electronic submissions in eCTD format also have specific requirements for PDF navigation, including the use of bookmarks to provide access to sections, tables, figures, references, and appendices.
Meeting these requirements is only one part of bookmark quality. Bookmarks must also remain valid as the document changes. A bookmark may point to a page that has been deleted, reference an incorrect destination, or contain a broken URL. Formatting problems can also make bookmarks inconsistent with the requirements for a particular document or submission.
AutoBookmark for Adobe Acrobat provides PDF bookmark validation to systematically check for these types of problems. It can identify invalid bookmark destinations, bookmarks pointing to incorrect or unavailable pages, broken URL references, and bookmark formatting or structural issues. This provides a practical way to check an entire document rather than relying on manual inspection of individual bookmarks.
For legal professionals preparing court filings, and healthcare or pharmaceutical teams preparing regulatory submissions such as FDA eCTD applications, bookmark validation can be an important part of PDF quality assurance and document compliance. This tutorial explains how to use AutoBookmark's PDF bookmark validation feature and review the issues it identifies.
Prerequisites
You need a copy of the Adobe® Acrobat® Standard/Pro along with the AutoBookmark™ plug-in installed on your computer in order to use this tutorial. You can download trial versions of both the Adobe® Acrobat® Pro and the AutoBookmark™ plug-in.
Running PDF Bookmark Validation
Open a PDF document in Adobe Acrobat and select Plugins > Bookmarks > Validate... from the menu or choose corresponding icon from AutoBookmark's Bookmarks tool.
[⚡ How to locate Plugins menu in Adobe® Acrobat® ⚡]
Select any optional checks in the Validate Bookmarks dialog that you want to apply, then click the Validate... button to start the validation.
The validation results are displayed in a tree view, with each bookmark that has issues shown as a separate node. Any issues detected for a bookmark are listed beneath its corresponding bookmark node, making it easy to identify the specific problems associated with it. A single bookmark may have multiple reported issues, depending on the validation options selected.
Here is an example of the validation results.
Reviewing pdf bookmarks errors and issues
Saving Results
Click the Save Report... button to save the current results as a spreadsheet-ready CSV or tab-delimited text file. CSV files can be opened directly in Microsoft Excel.
Exporting validation report as CSV file and viewing in Excel
Validation Checks and Options
Validation Check Description
Empty bookmark title Checks for bookmarks that do not have a title.
Bookmark without any assigned actions Checks for bookmarks that do not have an action assigned to them. A PDF bookmark action defines what happens when the user selects the bookmark. The action can, for example, navigate to a specific page or destination within the document, open another PDF or file, open a web URL, or perform another supported PDF action. A bookmark can have one or more actions associated with it.
Invalid or deleted destination page Checks whether a bookmark points to a page that is invalid or has been deleted.
Unresolved named destination Checks whether a named destination resolves to a page within the current document. A named destination is a predefined location in a PDF, identified by a unique name rather than directly by a page number or page view. A bookmark can use a named destination as its target, allowing it to navigate to that location when selected.
Bookmark pointing outside the current document Checks for bookmarks whose destinations point outside the current document. Bookmarks that point to a page outside the current document can be problematic because the referenced page is not actually part of the PDF being reviewed. This can occur when a bookmark retains a destination from another document after pages have been copied, replaced, or the document has been assembled from multiple sources. Such a bookmark may fail to navigate as expected or behave differently depending on the PDF viewer.
Multiple bookmarks pointing to the same page Checks for multiple bookmarks that point to the same page.
Missing destination file Checks whether the destination file exists for Open a file and Go to a page view in another document actions.
Non-functional web link Checks whether an Open web link action points to a functional URL. Requires an Internet connection.
Page view not using Inherit Zoom Checks whether bookmarks to page views use the "Inherit Zoom" setting. Inherit Zoom is a PDF page-view setting that tells a bookmark to preserve the current zoom level when navigating to its destination, rather than specifying a fixed zoom level. This is frequently required because it allows users to navigate between bookmarked locations without unexpectedly changing the document's magnification. For example, the California Courts of Appeal require all PDF bookmarks to use the "Inherit Zoom" setting for electronically filed documents. The FDA also specifies "Inherit Zoom" for bookmarks in its eCTD submission guidance, and its current eCTD validation rules explicitly flag bookmarks that do not use this setting. These requirements illustrate why validating bookmark zoom settings can be an important part of preparing PDFs for regulatory and court submissions.
Use Plugins > Bookmarks > Modify Bookmarks > Set Zoom Type... menu to set all bookmarks to use "Inherit Zoom". This operation will automatically set all bookmarks that are pointing to pages in the document to "Inherit Zoom". However, please note that some zoom types may produce undesirable results when converting to use "Inherit Zoom" because they are not pointing to any particular location on the page (for example, "Fit Height").
Duplicate bookmark title Checks for multiple bookmarks with the same title. Duplicate bookmark titles can make a document's navigation structure confusing, particularly when the bookmarks appear at the same hierarchy level or lead to different destinations.
Multiline or non-printable bookmark title Checks for bookmark titles containing multiple lines or non-printable characters. Multiline bookmark titles or titles containing non-printable characters can cause inconsistent display and navigation behavior across PDF viewers and may indicate improperly generated or formatted bookmarks.
Bookmark title longer than 80 characters Checks for bookmark titles that exceed 80 characters. Long bookmark titles can be difficult to read in the navigation pane and may be truncated or displayed inconsistently by different PDF viewers.
Bookmark executing JavaScript Checks for bookmarks that execute JavaScript code. Bookmarks that execute JavaScript can be problematic because JavaScript support varies significantly among PDF viewers, particularly lightweight or built-in viewers on some platforms. A bookmark that relies on JavaScript may therefore work in Adobe Acrobat but fail to perform the expected action in another viewer. Detecting JavaScript-based bookmarks helps identify potential compatibility issues and ensures that document navigation does not depend on functionality that may not be supported by the intended PDF viewer.
Bookmark with multiple actions Checks for bookmarks that have more than one action assigned to them. A bookmark with multiple actions can be problematic because the actions may depend on a specific execution order and may not be supported consistently by different PDF viewers. For example, a bookmark might be configured to first navigate to a page and then execute JavaScript or open another document. If the viewer does not support one of those actions, or handles the action sequence differently, selecting the bookmark may produce an unexpected result. Detecting multiple-action bookmarks is therefore useful when a document is expected to use simple, predictable bookmark navigation. It can also identify bookmarks that do not conform to filing or document-production requirements that expect each bookmark to perform a single navigation action.
Direct Editing of Bookmark Action
Double-click a bookmark in the validation results to open the Edit Action dialog for that bookmark. You can then review and modify its action directly without having to locate the bookmark in the PDF's bookmark panel. This is especially useful when the validation results contain multiple issues that require individual corrections. After making the necessary changes, you can continue reviewing the validation results and edit other bookmarks in the same way, making the validation and correction process faster and more efficient.
Repairing Bookmarks
The Repair Bookmarks feature is designed to help recover bookmarks created by third-party PDF applications that do not fully comply with PDF specifications and may produce bookmarks that do not work correctly or are not properly processed by Adobe Acrobat. The feature exports the existing bookmarks to a special data file, removes the existing bookmark structure, and then recreates the bookmarks from the saved data. This can help rebuild the bookmark structure in a form that Adobe Acrobat can process correctly.
Press Repair Bookmarks... button to run this operation on the currently open PDF file.
Processing Multiple PDF Files
This operation is available in Guided Actions tool (aka Action Wizard) and can be applied to multiple PDF files without any need to open documents and using menus. Guided Actions is a great automation tool that comes with Adobe Acrobat Pro.