Skip to main content

PDF Tools

Performs page-level operations on PDF files: splitting, extracting, deleting, and combining documents.

Overview

The PDF Tools node exposes four operations behind a single node. The first three — Split, Extract, and Delete — act on one PDF file at a time, while Combine merges an array of PDF files into one document.

Split, Extract, and Delete each support two modes:

  • Manual: Specify pages or ranges directly (e.g., 1-3, 5)
  • Smart: Describe what you want in plain language and let AI detect the pages

Use it to:

  • Split a batch of invoices into separate files
  • Extract only the pages you need from a report
  • Remove blank pages or cover sheets
  • Merge multiple PDFs into a single document

Parameters

The available parameters depend on the selected Operation.

ParameterDescriptionRequired
OperationSplit, Extract, Delete, or CombineYes
File DestinationDestination folder for the processed file(s)Yes

Operation

Selects which PDF operation to run. The remaining parameters change based on this choice.

  • Split, Extract, Delete — take a single File
  • Combine — takes an array of PDF Files

Split

Splits one PDF into multiple files.

ParameterDescriptionRequired
FilePDF file to processYes
Split ModeManual or Smart (default Smart)Yes
Split PointsStart a new file at these pages (e.g., 5, 9)In Manual mode
Split InstructionsDescribe how to split — e.g. separate each invoiceIn Smart mode

The File parameter expects a single PDF file, typically from an upstream node:

{{$item.data.file}}

Extract

Keeps only the specified pages and discards the rest.

ParameterDescriptionRequired
FilePDF file to processYes
Extract ModeManual or Smart (default Smart)Yes
Extract RangesPage ranges to extract (e.g., 1-3, 4-5)In Manual mode
Extract InstructionsDescribe pages to keep — e.g. keep all pages with tablesIn Smart mode

Delete

Removes the specified pages and keeps the rest.

ParameterDescriptionRequired
FilePDF file to processYes
Delete ModeManual or Smart (default Smart)Yes
Delete RangesPage ranges to delete (e.g., 1, 4-5)In Manual mode
Delete InstructionsDescribe pages to remove — e.g. delete all blank pages, remove cover sheetsIn Smart mode

Combine

Merges multiple PDF files into a single document.

ParameterDescriptionRequired
PDF FilesArray of PDF files to combineYes
note

Unlike the other operations, Combine takes an array of files rather than a single File. An expression that resolves to a single file will not work here — the input must be an array.

Files are combined in the order they appear in the array. Use Aggregate to collect files from multiple items first:

{{$item.data.files}}

At least one file must be provided.

Settings

SettingDescription
Execution ModeOnce per item (default) or Once
Output ModeHow to output results when running once
Batch SizeItems to process concurrently (default 5)
Stop on ErrorStop workflow on failure

Output

Each operation outputs one item per resulting file. Split may produce several output files, and each of its items includes a split index:

{
"file": {
"type": "fileData",
"name": "document-1.pdf",
"fileInfo": { "type": "..." }
},
"splitIndex": 1,
"totalSplits": 3
}

Extract, Delete, and Combine each output a single item containing only the resulting file:

{
"file": {
"type": "fileData",
"name": "document_extracted.pdf",
"fileInfo": { "type": "..." }
}
}

Access in expressions:

  • File object: {{$item.data.file}}
  • Position in output set (Split only): {{$item.data.splitIndex}}
  • Total number of files produced (Split only): {{$item.data.totalSplits}}

Examples

Split Invoices into Separate Files

[Google Drive (invoice PDF)] → [PDF Tools (Split, Smart)] → [Copy File]

Use Smart mode with instructions like separate each invoice to detect split points automatically.

Extract Specific Pages

[OneDrive Trigger] → [PDF Tools (Extract, Manual)] → [Send Gmail]

Set Extract Ranges to 1-3 to keep only the first three pages.

Remove Blank Pages

[OCR PDF] → [PDF Tools (Delete, Smart)] → [Copy File]

Use Smart mode with delete all blank pages to clean up scanned documents.

Combine Multiple Reports

[Google Drive (reports folder)] → [Aggregate (collect files)] → [PDF Tools (Combine)] → [Send Gmail]

Tips

  • Split, Extract, and Delete work on a single file; Combine works on an array of files
  • Smart mode is the default for Split, Extract, and Delete — describe the pages in plain language and AI detects them
  • Manual mode expects page numbers or ranges (e.g., 1-3, 5); Split Points mark where each new file begins
  • Use Aggregate before Combine to gather files from multiple items into an array
  • These are long-running operations for large documents
  • Use Rename File afterward to set meaningful output filenames