PDF Web Links and Named Destinations

By Michael Peters · Published March 17, 2026 · Last updated March 24, 2026

You can also convert text URLs to clickable links in PDFs online for free using Mapsoft's PDF Hub — no installation required.

PDF web links have revolutionised the way we share and access documents online. They allow users to navigate directly to specific pages and sections, enhancing the user experience significantly.

Consider a scenario where a user is looking for a specific case study within a lengthy legal document. By employing PDF web links, they can access the relevant section instantly, saving time and improving efficiency.

1. Basic URL Fragment for Page Navigation

You can append #page=X to the URL of the PDF, where X is the page number you want to navigate to. This trick can be useful when sharing PDF web links with others.

This method is particularly useful for educators and trainers who need to direct their students to specific content without the hassle of searching through entire documents.

This direct linking capability can also facilitate smoother presentations and meetings, where participants can quickly jump to the necessary content without delay.

Example:

https://www.example.com/documents/sample.pdf#page=5

This will open the PDF at page 5 when accessed in most web browsers that support PDF viewing through PDF web links.

2. Named Destinations

If you want more control or need to link to a specific section, you can create named destinations in your PDF. Use tools like Adobe Acrobat or another PDF editor to do this.

Furthermore, utilising named destinations enables a deeper layer of organisation within a document, allowing users to navigate to specific headers or sections with ease. This pairs well with PDF bookmarks, which provide another navigation layer within a document.

This feature is invaluable for creating user-friendly resources, such as reports, eBooks, or manuals, where quick access to information is crucial.

Steps to Create Named Destinations:

1. Open your PDF in Adobe Acrobat.
2. Navigate to the page and position you want to create a destination for.
3. Go to View > Show/Hide > Navigation Panels > Destinations.
4. Click New Destination and give it a meaningful name (e.g., "Introduction").

Link to the Named Destination:

You can then link to a named destination by appending #nameddest=DestinationName to the PDF URL when creating PDF web links.

Example:

https://www.example.com/documents/sample.pdf#nameddest=Introduction

This will open the PDF at the location of the named destination called "Introduction".

3. Combining Page Number and Zoom Level

Combining page numbers with zoom levels allows users to not only reach the desired page but also view it in the preferred size. This is especially beneficial for users with visual impairments.

You can specify the zoom level and page layout using additional parameters in the URL:

Example:

https://www.example.com/documents/sample.pdf#page=5&zoom=150

4. Browser Compatibility

By ensuring that PDF web links function across various browsers, you create a more inclusive document that considers different user environments and preferences.

These methods work in most modern browsers that support PDF rendering. Keep in mind the following points:

• Chrome, Edge, and Firefox have built-in PDF viewers that support page navigation and named destinations.
• Safari's PDF handling may vary depending on the version and operating system.
• Some browser extensions or corporate security settings may interfere with PDF URL parameters.
• Mobile browsers may have limited support for advanced PDF navigation features.

5. Testing the URLs

Always test the URLs in different browsers to ensure they work as expected. Some configurations or browser extensions might interfere with the functionality of PDF web links.

Testing these links regularly helps identify and fix any issues proactively, ensuring that users always have a smooth experience.

How Links Are Stored in the PDF Object Model

When you click a hyperlink in a PDF, what you are actually activating is an annotation. Specifically, a Link annotation — a rectangle defined in page coordinates that carries an associated action. The ISO 32000 specification defines this in Section 12.5.6.5. The annotation dictionary has a /Subtype of /Link, a /Rect array giving the clickable boundary on the page, and an /A entry (or /Dest for internal destinations) specifying what happens when it is activated.

For external URLs, the action is a URI action — a dictionary with /S /URI and a /URI string containing the URL itself. There is no HTML href equivalent; the URL is simply a byte string. This matters for programmatic work: if you are searching for or replacing URLs in a document, you need to traverse the annotation dictionaries on each page rather than searching page content streams, where the visible URL text lives separately from the clickable action.

For internal navigation — links that jump to another page within the same document — the action is typically a GoTo action pointing either at a page number (using an explicit destination array) or at a named destination. Named destinations are registered in the document's name tree, which makes them much more robust when pages are added or removed. A link pointing to page 47 by number breaks if you insert 3 pages before it; a link pointing to the named destination "section-3" remains valid as long as the destination is maintained alongside its anchor point.

Creating Links Programmatically

Creating links in code is straightforward once you understand the annotation structure. In Acrobat JavaScript, you can add a link annotation to a page using the addAnnot method, specifying the bounding rectangle and the action. The same operation in C++ via the Acrobat SDK uses the AVPageViewAddAnnot family of functions. In the Adobe PDF Library, you create an annotation object, set its subtype, bounds, and action properties, and add it to the page's annotation array.

A common pattern in production PDF workflows is converting text URLs to clickable links. A document arrives from an author with URLs typed as plain text — www.example.com — and needs to be post-processed to make those URLs clickable. You can do this with Mapsoft's free online URL-to-link converter, or programmatically by searching the content stream for URL patterns and creating corresponding Link annotations positioned over the text. The latter approach requires careful coordinate mapping between text character positions (in PDF user space) and the annotation rectangle.

Acrobat also has a built-in tool for this under Edit > Links > Detect and Create Web Links, which handles the most common cases automatically. For large or complex documents, or for batch processing, programmatic approaches give you more control over which patterns are detected and how the resulting links appear.

Managing Links in Large Documents

Large technical documents — standards, manuals, reference guides running to several hundred pages — often accumulate hundreds or thousands of links over their revision history. Managing these programmatically becomes necessary. Common tasks include auditing all links in a document, updating URLs when a website is restructured, converting all page-number-based internal destinations to named destinations to improve robustness, and validating that external URLs still resolve.

Broken link detection deserves particular attention. A PDF distributed as a standalone file may contain external links that were valid at time of publication but have since rotted. For living documents, periodic validation is valuable. Programmatically, this means extracting all URI actions from the document's annotation dictionaries, then issuing HTTP HEAD requests to each URL and logging failures. Our TOCBuilder v2 plug-in includes functionality for reporting and managing links across a document, including identifying links with missing or malformed destinations.

Search and replace for URLs is another practical requirement. If your organisation moves from http:// to https://, or migrates to a new domain, you need to update all URI actions in every PDF in your archive. This is not a text search operation — it requires traversing the document structure and updating annotation action dictionaries. The Acrobat SDK and PDF Library both provide the access needed to do this reliably.

Link Appearance and Accessibility

By default, links in PDF can be invisible (no border, no colour) — they are clickable areas the user cannot see. This is common for links placed over text that is already visually styled to look like a hyperlink. Alternatively, the annotation can specify a visible border with colour, thickness, and style. The /BS (Border Style) and /C (Colour) entries in the annotation dictionary control this. For printed documents, invisible borders are usually preferable; for screen-only documents, visible styling helps users identify interactive areas.

For accessibility, links should have an associated structure element in the document's tag tree, with meaningful alternate text. A Link annotation without a corresponding tagged structure is accessible but provides no context to screen readers beyond the URL itself. A well-structured tagged PDF gives each link meaningful alt text — the visible link text or a description of the destination. This is required for PDF/UA compliance and is good practice for any document intended for broad distribution. Our PDF accessibility guide covers the tagging requirements in more detail.

Summary

Incorporating these strategies into your document management practices can lead to improved information dissemination and better user satisfaction.

Integrating these approaches creates not only functional documents but also professional ones that reflect attention to detail and user engagement.

By leveraging tools that help create PDF web links, you can enhance the accessibility and usability of your documents, making them an invaluable asset for your audience. For related navigation techniques, see our guides on PDF bookmarks and PDF annotations.