orizpdf-tools

tools blog pdf tips

5 min read by Chirag Singhal


Hyperlinks transform static PDF documents into interactive, navigable resources. Whether you are linking to external websites, cross-referencing sections within a long report, or creating an interactive table of contents, understanding PDF hyperlinks is essential for producing professional, user-friendly documents.

3 types
External, internal, and page links
1994
Hyperlinks introduced in PDF 1.1
100%
Compatibility across modern PDF readers
4+
Link action types supported

PDF supports several types of hyperlink actions, each serving a different purpose:

External links point to resources outside the PDF, typically web URLs. When a reader clicks an external link, their default web browser opens and navigates to the specified URL. External links are essential for referencing online resources, directing readers to your website, or citing web-based sources.

Internal links navigate to a specific location within the same PDF document. This can be a named destination, a specific page, or a particular position on a page with a defined zoom level. Internal links are the backbone of document navigation, powering table of contents entries, cross-references, and index entries.

A simpler form of internal link, page links navigate to a specific page number. Unlike GoTo actions, which can target precise coordinates and zoom levels, page links simply display the target page at the default view.

PDF also supports additional action types:

  • GoToR (Remote GoTo): Links to a location in a different PDF file
  • Launch: Opens an external file or application
  • Named actions: Predefined actions like “Next Page,” “Previous Page,” or “Print”
  • JavaScript actions: Execute JavaScript code within the PDF viewer
FeatureExternal LinkInternal Link
Opens web browser✅ Yes❌ No
Navigates within document❌ No✅ Yes
Requires internet connection✅ Yes❌ No
Supports zoom level control❌ No✅ Yes
Works offline❌ No✅ Yes
Used for references/citations✅ Yes❌ No
Used for table of contents❌ No✅ Yes

The most reliable method for adding hyperlinks to PDFs is to create them in the source document before converting to PDF. Word processors, design tools, and presentation software all support hyperlink creation, and these links are preserved during PDF conversion.

In Microsoft Word: Select the text you want to turn into a link, right-click, and choose “Link” or press Ctrl+K. Enter the URL for external links or select a heading/bookmark for internal links. When you save or export as PDF, the links are automatically preserved.

In Google Docs: Select text, press Ctrl+K, and enter the URL or choose a heading from the document. Google Docs exports hyperlinks correctly to PDF.

In Adobe InDesign: Use the Hyperlinks panel to create links. InDesign offers precise control over link appearance, destination, and behavior, making it ideal for professional publications.

If you need to add hyperlinks to an existing PDF without access to the source document, PDF editing tools provide link annotation capabilities:

1

Open the PDF in an editing tool

Use a PDF editor that supports link annotations. Most professional and many free tools offer this capability.

2

Select the link tool

Choose the hyperlink or link annotation tool from the toolbar. This typically allows you to draw a rectangle over the area you want to make clickable.

3

Draw the link area

Click and drag to create a rectangle over the text or image that should be clickable. The rectangle defines the link's clickable region.

4

Specify the link destination

Enter the URL for external links, select a page or bookmark for internal links, or choose a named action for navigation controls.

5

Set link appearance

Choose how the link appears: visible rectangle with a border, invisible (no visual indicator), or underlined text. Match the style to your document's design.

6

Test the link

Switch to viewing mode and click the link to verify it navigates to the correct destination.

One of the most valuable uses of PDF hyperlinks is creating a clickable table of contents. A well-linked TOC allows readers to jump directly to any section of the document with a single click.

Best Practices for Linked TOCs

  • Use consistent formatting: All TOC entries should share the same visual style
  • Include page numbers: Display page numbers alongside linked text so readers know where they are navigating
  • Mirror the document structure: The TOC should reflect the actual heading hierarchy of the document
  • Add return links: Consider adding “Back to TOC” links at the end of each section for easy navigation
  • Test all links: Verify that every TOC entry navigates to the correct page before distributing the document
💡

Automatic TOC Generation

Many modern document processors automatically generate linked tables of contents when exporting to PDF. In Microsoft Word, use the References tab to insert an automatic TOC. In LaTeX, the table of contents is generated automatically with the \tableofcontents command.

PDF editors typically provide a panel or view that lists all hyperlinks in the document. This is invaluable for reviewing, auditing, and managing links, especially in large documents.

To change where a link points, select the link annotation and modify its destination. You can update URLs, change target pages, or switch between external and internal link types.

To remove a link, select the link annotation and delete it. This removes the clickable behavior but preserves the underlying text or image. Some tools also offer bulk link removal for stripping all hyperlinks from a document.

PDF links can appear in several ways:

  • Visible border: A colored rectangle around the link area
  • Invisible: No visual indicator, the link is activated by clicking the text
  • Underlined: Text appears underlined, similar to web links

The invisible style is most common for professional documents, as it maintains clean visual design while providing interactivity.

PDF hyperlinks can pose security risks if not managed carefully. Malicious PDFs have been used in phishing attacks, directing users to harmful websites through deceptive link text.

Security Best Practices

  • Verify link destinations: Always ensure the visible link text matches the actual URL destination
  • Avoid shortened URLs: Short URLs obscure the true destination and can be exploited
  • Warn about external links: If your PDF directs users to external websites, consider adding a visual indicator or disclaimer
  • Disable JavaScript links: JavaScript actions in PDFs can be used maliciously. Disable JavaScript execution in your PDF reader’s security settings if not needed
  • Use HTTPS: All external links should use HTTPS rather than HTTP to ensure encrypted connections
⚠️

Security Alert

Never click links in PDFs from unknown or untrusted sources. Malicious PDFs can contain links to phishing sites, malware downloads, or JavaScript actions that exploit vulnerabilities in PDF readers.

Accessible PDFs require properly structured hyperlinks so that assistive technologies can navigate and announce them correctly.

  • Descriptive link text: Avoid generic text like “Click here.” Use descriptive text such as “Visit our documentation for details” so screen reader users understand the link’s purpose without surrounding context
  • Link annotations must be tagged: The PDF’s logical structure must include link annotations so screen readers can identify and activate them
  • Alternative descriptions: Provide alternative text for image-based links
  • Consistent navigation: Links should follow a logical order that matches the visual reading sequence

Add Page Numbers to Your PDF

Page numbers improve navigation and make your linked table of contents more useful. Add them with our free tool.

Add Page Numbers

Named Destinations

Named destinations provide a more robust alternative to page-number-based internal links. A named destination is a label assigned to a specific location in the PDF. If pages are added or removed, named destinations automatically point to the correct location, while page-number links may break.

GoToR (Remote GoTo) actions allow links to point to specific locations in other PDF files. This is useful for document sets, such as a main report with supporting appendices in separate files.

Launch Actions

Launch actions open external files or applications when clicked. While powerful, these should be used sparingly and with clear disclosure to the user, as they can trigger unexpected behavior.

PDF supports JavaScript actions attached to links, enabling dynamic behavior such as form calculations, conditional navigation, and interactive popups. However, JavaScript support varies across PDF readers and is often disabled for security reasons.

Frequently Asked Questions

Can I add hyperlinks to a scanned PDF?
Scanned PDFs contain images rather than text, so you need to add link annotations manually by drawing clickable rectangles over the desired areas. OCR processing can help identify text, but the links must still be added as annotations.
Why do my links stop working after merging PDFs?
Internal links based on page numbers may break when documents are merged because page numbers shift. Use named destinations instead of page numbers for more robust linking that survives document modifications.
How do I create a clickable table of contents in a PDF?
The best approach is to create the TOC with links in your source document (Word, InDesign, etc.) before converting to PDF. For existing PDFs, use a PDF editor to add link annotations to each TOC entry pointing to the corresponding page.
Can PDF links open in a new window?
PDF does not have a direct equivalent of HTML's target='_blank' attribute. External links open in the system's default browser. Internal links navigate within the same PDF document.
Are PDF hyperlinks supported on all devices?
Yes, external and internal hyperlinks are supported by all modern PDF readers on desktop and mobile platforms. JavaScript-based links may not work on all mobile PDF readers.
How do I check if all my PDF links work correctly?
Manually click each link to verify it navigates to the correct destination. For large documents, some PDF tools can extract and list all links for batch verification.

— iii — pdf-tools.oriz.in