Actions80
- Extract Text From Word
- Find And Replace Text
- Convert PDF To Editable PDF Using OCR
- Create Swiss QR Bill
- Split PDF By Barcode
- Split PDF By Swiss QR
- Split PDF By Text
- Split PDF Regular
- Create PDF/A
- Convert HTML To PDF
- Convert Markdown To PDF
- Upload File To PDF4me
- Add Attachment To PDF
- Add Barcode To PDF
- Add Form Fields To PDF
- Fill PDF Form
- Add HTML Header Footer
- Add Image Stamp To PDF
- Add Margin To PDF
- Add Page Number To PDF
- Add Text Stamp To PDF
- AI-Invoice Parser
- AI-Process HealthCard
- AI-Process Contract
- Generate Barcode
- Classify Document
- Parse Document
- Linearize PDF
- Flatten PDF
- Convert To PDF
- Json To Excel
- Convert PDF To Excel
- Convert PDF To Word
- Convert PDF To PowerPoint
- Convert VISIO
- Crop Image
- Delete Blank Pages From PDF
- Delete Unwanted Pages From PDF
- Extract Pages
- Merge Multiple PDFs
- Overlay PDFs
- Rotate Document
- Rotate Page
- Sign PDF
- URL to PDF
- Add Image Watermark To Image
- Add Text Watermark To Image
- Compress Image
- Convert Image Format
- Create Images From PDF
- Flip Image
- Get Image Metadata
- Image Extract Text
- Remove EXIF Tags From Image
- Replace Text With Image
- Replace Text With Image In Word
- Resize Image
- Rotate Image
- Rotate Image By EXIF Data
- Compress PDF
- Get PDF Metadata
- Repair PDF Document
- Get Document From Pdf4me
- Update Hyperlinks Annotation
- Protect Document
- Unlock PDF
- Disable Tracking Changes In Word
- Enable Tracking Changes In Word
- Generate Document Single
- Generate Documents Multiple
- Get Tracking Changes In Word
- Read Barcode From Image
- Read Barcode From PDF
- Read SwissQR Code
- Extract Form Data From PDF
- Extract Pages From PDF
- Extract Attachment From PDF
- Extract Text By Expression
- Extract Table From PDF
- Extract Resources
Overview
The "Update Hyperlinks Annotation" operation in this node allows users to modify hyperlinks within a PDF document. Specifically, it can search for existing hyperlink text or URLs and replace them with new display text or new URL destinations. This is useful when you need to update outdated links, correct errors, or customize the appearance of hyperlinks in PDFs without recreating the entire document.
Common scenarios include:
- Updating company URLs in marketing materials.
- Correcting broken or changed links in documentation.
- Customizing link display text for better readability or branding.
For example, you might provide a PDF containing hyperlinks pointing to "http://www.google.com" and want to change both the displayed text and the actual URL to "https://pdf4me.com".
Properties
| Name | Meaning |
|---|---|
| Input Data Type | How the PDF input is provided. Options: • Binary Data — Use PDF file from previous node. • Base64 String — Provide PDF content as base64 encoded string. • URL — Provide URL to PDF file. |
| Binary Property Name | Name of the binary property containing the PDF (used only if Input Data Type is Binary Data). |
| Base64 Content | Base64-encoded PDF content (used only if Input Data Type is Base64 String). |
| PDF URL | URL to the PDF file to update hyperlinks annotation (used only if Input Data Type is URL). |
| Output File Name | Name for the output PDF file after updating hyperlinks. Defaults to "hyperlinks_updated_PDF_output.pdf". |
| Search On | Criteria to search for hyperlinks. Options: • Text — Search by the hyperlink's display text. • URL — Search by the hyperlink's destination URL. |
| Search Value | The text or URL value to search for in the PDF's hyperlinks. |
| Is Expression | Whether to use expression matching for the search value. If true, the search value can be treated as an expression or pattern rather than a fixed string. |
| Text Current Value | The current hyperlinked text to replace (used when updating the display text of a hyperlink). |
| Text New Value | The new display text for the hyperlink after replacement. |
| URL Current Value | The current URL destination to replace (used when updating the hyperlink's target URL). |
| URL New Value | The new URL destination to set for the hyperlink. |
| Async | Whether to process the operation asynchronously. |
Output
The node outputs the updated PDF file with modified hyperlinks. The output includes:
- A JSON object containing metadata about the processed file.
- The updated PDF file data is returned as binary data under the specified binary property name.
- The output file will have the name specified in the "Output File Name" property.
If the input was binary or base64, the output will be binary data representing the updated PDF. If the input was a URL, the node downloads the PDF, updates it, and outputs the updated binary PDF.
Dependencies
- Requires access to the PDF processing service that supports hyperlink annotation updates.
- Needs appropriate API credentials or authentication tokens configured in n8n to interact with the PDF processing backend.
- Internet access may be required if providing the PDF via URL or if the service is cloud-based.
Troubleshooting
Issue: PDF not updating or hyperlinks remain unchanged.
Cause: The search criteria ("Search On" and "Search Value") may not match any existing hyperlinks.
Solution: Verify the exact text or URL present in the PDF hyperlinks. Try toggling "Is Expression" off to do exact matches.Issue: Node fails with file not found or download error when using URL input.
Cause: The provided PDF URL is invalid, inaccessible, or requires authentication.
Solution: Check the URL correctness and accessibility. Ensure the URL is publicly accessible or provide credentials if needed.Issue: Output file is corrupted or cannot be opened.
Cause: Input PDF might be malformed or the update process failed silently.
Solution: Validate the input PDF integrity. Try with a different PDF file.Error Messages:
- Errors related to missing binary data or base64 content indicate incorrect input configuration. Make sure the input data type matches the provided data.
- Authentication or permission errors suggest misconfigured API credentials.
Links and References
- PDF Hyperlink Annotations - General Info (PDF specification)
- n8n Documentation on Working with Binary Data
- Best Practices for PDF Link Management (Advanced PDF features)
This summary is based on static analysis of the node's code and provided properties, focusing on the "Update Hyperlinks Annotation" operation only.