Merge and combine PDF files with an SDK

Concatenate PDFs, assemble documents from mixed formats, and control page-level insertion across 10 platforms — from server-side REST APIs and desktop SDKs to mobile and browser-based merging.

What do you want to do?

Merge PDF files

Combine multiple PDF files into a single document. Append entire documents or select specific pages to include.

Assemble from mixed formats

Combine PDFs with Word documents, images, and other formats into a single PDF. The SDK handles format conversion automatically.

Control page insertion

Insert pages before or after specific positions, select individual pages or ranges, and control the final page order.

Split and merge workflows

Split documents into parts and recombine them — extract pages from multiple sources and merge them into a new document.

How we help


DOCUMENT ENGINE

Server-side PDF merging via REST API

Merge PDF files and other documents through a REST API. Define the document sequence in a parts array, reference files by upload or URL, and receive a single combined PDF. Supports adding cover pages and assembling documents from multiple sources.

Illustration of PDF merging in the Document Engine
Parts-based composition

Define the merge sequence in a parts array — the order of parts controls the final document order.


Multiple input sources

Merge documents from file uploads or URLs in a single request. Add authorization tokens for protected sources.


Cover page insertion

Add cover pages or insert documents at specific positions in the final output.


Batch processing

Combine multiple documents in a single API call for automated document assembly pipelines.

WEB AND NODE.JS

Merge PDFs in the browser or on the server with JavaScript

Import documents into the current PDF with page-level control. Select specific pages or ranges to import, and place them before or after any page in the target document.

Illustration of PDF merging in the Web and Node.js SDKs
Page-level selection

Choose individual pages or page ranges to import from the source document.


Placement control

Insert imported pages before or after any page index in the target document.


Client and server

Merge documents in the browser with the Web SDK or on the server with Node.js using the same API pattern.

.NET SDK

Combine PDFs and mixed formats in a single call

Merge multiple files into a single PDF — including PDFs, images, Word documents, and Excel spreadsheets. The SDK handles format conversion automatically and supports PDF conformance level selection for the output.

Illustration of PDF merging in the .NET SDK
Mixed format input

Combine PDFs with JPG, PNG, TIFF, XLSX, TXT, and other formats into a single PDF output.


Single method call

Pass a list of file paths and receive a combined PDF. The SDK handles parsing and conversion internally.


PDF conformance control

Select the output PDF conformance level when combining documents.

PYTHON AND JAVA

Append and merge documents with automatic format conversion

Open a base document, append additional documents, and export the merged result as a single PDF. The SDK handles format conversion automatically — merge a Word document with a PDF in the same workflow.

Illustration of PDF merging in the Python and Java SDKs
Append-based merging

Open a base document, append additional files one by one, and save the combined result.


Cross-format support

Merge PDFs with Word documents — the SDK converts formats automatically during the append operation.


Language-native patterns

Python uses context managers for automatic resource cleanup. Java uses exception-based error handling.

IOS AND ANDROID

Merge PDFs on mobile devices

Merge PDF documents on iOS and Android with both programmatic APIs and a built-in UI. iOS initializes documents from multiple file data providers; Android uses a processor with page-level control over the final output.

Illustration of PDF merging in the iOS and Android SDKs
Programmatic and UI merging

Both platforms support programmatic APIs and a built-in UI for document import and merging.


Page-level control on Android

Select specific pages from each source document and control insertion order in the final output.


Multidocument initialization on iOS

Initialize a document from an array of file data providers — the order of providers determines the merge sequence.






Frequently asked questions

How do I merge PDF files programmatically?

Open the base document, import or append additional documents, and save the result. The exact API varies by platform — Web and Node.js use an import document operation, Python and Java use an append method, and .NET accepts a list of file paths in a single call.

Can I combine PDF files from different formats?

Yes. The .NET SDK, Python SDK, Java SDK, and Document Engine support merging PDFs with other formats like Word documents and images. The SDK handles format conversion automatically during the merge operation.

How do I merge specific pages from multiple PDFs?

The Web SDK, Node.js SDK, Android SDK, and React Native SDK support page-level selection. Specify individual page indexes or page ranges to import only the pages you need from each source document.

Can I concatenate PDF files on the server?

Yes. Document Engine provides a REST API for server-side merging — define the document sequence in a parts array and receive a combined PDF. The .NET SDK, Python SDK, Java SDK, and Node.js SDK also run server-side without GUI dependencies.

What platforms support PDF merging?

Nutrient supports PDF merging across 10 platforms: Web, Node.js, iOS, Android, .NET, Python, Java, React Native, MAUI, and Document Engine. Each platform provides a programmatic API, and iOS, Android, and MAUI also include a built-in UI for interactive merging.

How do I assemble a PDF from multiple document types?

Use the .NET SDK or Document Engine to combine files of different formats into a single PDF. The .NET SDK accepts PDFs, images (JPG, PNG, TIFF), Word documents, Excel spreadsheets, and text files in a single merge call.

Can I split and merge PDFs in the same workflow?

Yes. Use page-level selection to extract specific pages from multiple source documents and merge them into a new document. The Web, Node.js, Android, and React Native SDKs support selecting individual pages or ranges during import.

How do I combine PDF files in a mobile app?

Both iOS and Android SDKs support PDF merging. iOS initializes a document from multiple file data providers. Android uses a processor with page-level control. Both platforms also provide a built-in UI for interactive document import and merging.


FREE TRIAL

Ready to get started?

Start merging and combining PDF files in minutes — no payment information required.


Merge PDF SDK

What is a merge PDF SDK?

A merge PDF SDK lets developers programmatically combine multiple PDF files into a single document. Nutrient provides PDF merging across 10 platforms, from server-side REST APIs to browser-based, desktop, and mobile SDKs.

  • Merge PDF files by appending, importing, or concatenating documents.
  • Combine PDFs with images, Word documents, and other formats.
  • Select specific pages or ranges to include from each source.
  • Available on server, desktop, browser, and mobile platforms.
How to choose a PDF merger SDK

When selecting a PDF merger SDK, consider your deployment environment, the input formats you need to support, and whether you require page-level control over the merge operation.

  • Format support — The .NET SDK and Document Engine accept mixed formats (PDF, images, Office files). Other SDKs merge PDFs only.
  • Page-level control — Web, Node.js, Android, and React Native support selecting specific pages from each source document.
  • Deployment model — REST API for server pipelines, desktop SDK for local processing, browser SDK for interactive merging, mobile SDK for on-device assembly.
  • UI support — iOS, Android, and MAUI include a built-in UI for interactive document import and merging.
When should I use a combine PDF SDK vs. a document assembly tool?

A combine PDF SDK gives you programmatic control over the merge process — you decide which documents to include, which pages to select, and where to insert them. Use an SDK when merging is part of an automated workflow, API handler, or application feature. Use a standalone tool when you need one-off manual merges.

What are the benefits of Nutrient’s PDF merge SDK?

Nutrient provides PDF merging across 10 platforms, so you can combine documents wherever your application runs.

  • 10 platforms — Document Engine, .NET, Web, Node.js, Python, Java, iOS, Android, React Native, and MAUI.
  • Mixed format assembly — Combine PDFs with images, Word documents, and spreadsheets on .NET and Document Engine.
  • Page-level precision — Select individual pages or ranges and control insertion position.
  • Enterprise-proven — Trusted by Lufthansa, Disney, Autodesk, UBS, Dropbox, and IBM.
How does concatenating PDFs differ from merging?

Concatenating PDFs appends entire documents end-to-end in sequence. Merging is a broader term that includes concatenation plus page-level operations — selecting specific pages, inserting at specific positions, and interleaving pages from multiple sources. Nutrient supports both approaches across all platforms.