.NET Merge PDF: Combine Multiple Files with IronPDF

How Do You Install the Library?

Getting started requires a simple NuGet package installation. Open the Package Manager Console in Visual Studio and run:

Install-Package IronPdf

Install-Package IronPdf

Or use the .NET CLI:

dotnet add package IronPdf

dotnet add package IronPdf

IronPDF handles all the complex PDF manipulation behind the scenes, letting you focus on your application logic. This process is compatible with various operating systems, including Linux via .NET Core. For detailed installation guidance, visit the IronPDF installation documentation.

How Do You Merge Two PDF Documents?

The most basic merging scenario involves combining two existing PdfDocument objects. Here's how to accomplish this task:

using IronPdf;

// Load the PDF documents
var pdf1 = PdfDocument.FromFile("Invoice1.pdf");
var pdf2 = PdfDocument.FromFile("Invoice2.pdf");

// Merge the documents
var merged = PdfDocument.Merge(pdf1, pdf2);

// Save the merged document
merged.SaveAs("Merged.pdf");

using IronPdf;

// Load the PDF documents
var pdf1 = PdfDocument.FromFile("Invoice1.pdf");
var pdf2 = PdfDocument.FromFile("Invoice2.pdf");

// Merge the documents
var merged = PdfDocument.Merge(pdf1, pdf2);

// Save the merged document
merged.SaveAs("Merged.pdf");

Imports IronPdf

' Load the PDF documents
Dim pdf1 = PdfDocument.FromFile("Invoice1.pdf")
Dim pdf2 = PdfDocument.FromFile("Invoice2.pdf")

' Merge the documents
Dim merged = PdfDocument.Merge(pdf1, pdf2)

' Save the merged document
merged.SaveAs("Merged.pdf")

This code demonstrates the simplicity of merging PDFs with IronPDF. The PdfDocument.FromFile() method loads existing PDF files into memory. These loaded documents become PdfDocument objects that can be manipulated programmatically.

The Merge() method takes two or more PdfDocument objects and combines them into a single PDF file. The pages from the second document are appended after the pages of the first document, maintaining the original order and formatting of each page.

Finally, SaveAs() writes the merged document to disk. The resulting PDF contains all pages from both source documents in sequence, ready for distribution or further processing.

How Do You Merge Multiple PDF Files at Once?

Real-world applications often need to merge more than two documents. IronPDF handles this scenario using a List collection:

using IronPdf;
using System.Collections.Generic;
using System.IO;

// Create a list to store PDF documents
var files = new List<PdfDocument>();

// Get all PDF files from a directory
string[] fileNames = Directory.GetFiles(@"C:\Reports\", "*.pdf");

// Load each PDF file
foreach (var fileName in fileNames)
{
    files.Add(PdfDocument.FromFile(fileName));
}

// Merge all PDFs into one
var merged = PdfDocument.Merge(files);

// Save the combined document
merged.SaveAs("CombinedReports.pdf");

using IronPdf;
using System.Collections.Generic;
using System.IO;

// Create a list to store PDF documents
var files = new List<PdfDocument>();

// Get all PDF files from a directory
string[] fileNames = Directory.GetFiles(@"C:\Reports\", "*.pdf");

// Load each PDF file
foreach (var fileName in fileNames)
{
    files.Add(PdfDocument.FromFile(fileName));
}

// Merge all PDFs into one
var merged = PdfDocument.Merge(files);

// Save the combined document
merged.SaveAs("CombinedReports.pdf");

Imports IronPdf
Imports System.Collections.Generic
Imports System.IO

' Create a list to store PDF documents
Dim files As New List(Of PdfDocument)()

' Get all PDF files from a directory
Dim fileNames As String() = Directory.GetFiles("C:\Reports\", "*.pdf")

' Load each PDF file
For Each fileName In fileNames
    files.Add(PdfDocument.FromFile(fileName))
Next

' Merge all PDFs into one
Dim merged As PdfDocument = PdfDocument.Merge(files)

' Save the combined document
merged.SaveAs("CombinedReports.pdf")

The code uses Directory.GetFiles() to automatically discover all PDF files in a specified folder, eliminating the need to hardcode individual file names. According to Microsoft's documentation on file operations, this method efficiently retrieves file paths matching your criteria.

Each discovered PDF file is loaded as a PdfDocument and added to a List collection. This approach scales efficiently whether you're merging three files or three hundred. The Merge() method accepts the entire list, processing all source documents in a single operation to create one new document.

The foreach loop provides a clean way to iterate through multiple PDF files. You can add filtering logic here to select specific files based on naming patterns, dates, or other criteria. This pattern works well for batch processing scenarios like monthly report compilation or document archival.

How Do You Merge PDF Files from Different Sources?

Sometimes you need to combine PDF files from various sources -- perhaps merging dynamically generated content with existing templates. Here is how IronPDF handles this pattern:

using IronPdf;

var renderer = new ChromePdfRenderer();

// Create a PDF from HTML
string html = @"<h1>Cover Page</h1>
               <p>Example PDF From Multiple Sources</p>
               <div style='page-break-after: always;'></div>";
var coverPage = renderer.RenderHtmlAsPdf(html);

// Load an existing PDF report
var pdf = PdfDocument.FromFile("invoice.pdf");

// Create a summary from URL
var summary = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");

// Merge all three sources
var finalDocument = PdfDocument.Merge(new[] { coverPage, pdf, summary });

// Save the complete document
finalDocument.SaveAs("MultipleSources.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Create a PDF from HTML
string html = @"<h1>Cover Page</h1>
               <p>Example PDF From Multiple Sources</p>
               <div style='page-break-after: always;'></div>";
var coverPage = renderer.RenderHtmlAsPdf(html);

// Load an existing PDF report
var pdf = PdfDocument.FromFile("invoice.pdf");

// Create a summary from URL
var summary = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");

// Merge all three sources
var finalDocument = PdfDocument.Merge(new[] { coverPage, pdf, summary });

// Save the complete document
finalDocument.SaveAs("MultipleSources.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Create a PDF from HTML
Dim html As String = "<h1>Cover Page</h1>
                      <p>Example PDF From Multiple Sources</p>
                      <div style='page-break-after: always;'></div>"
Dim coverPage As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Load an existing PDF report
Dim pdf As PdfDocument = PdfDocument.FromFile("invoice.pdf")

' Create a summary from URL
Dim summary As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF")

' Merge all three sources
Dim finalDocument As PdfDocument = PdfDocument.Merge(New PdfDocument() {coverPage, pdf, summary})

' Save the complete document
finalDocument.SaveAs("MultipleSources.pdf")

This example demonstrates IronPDF's versatility in handling different PDF sources. The ChromePdfRenderer class enables HTML to PDF conversion, perfect for generating dynamic cover pages or formatted content from your application data. The renderer supports modern web standards as outlined in W3C specifications.

The RenderHtmlAsPdf() method converts HTML strings directly to PDF, supporting full CSS styling and JavaScript. The RenderUrlAsPdf() method fetches and converts web content, useful for incorporating live data or external resources. You can learn more in the HTML to PDF tutorial.

By combining these rendering methods with existing PDF documents, you can create sophisticated document workflows. This approach works well for scenarios like adding branded cover pages to reports, appending legal disclaimers to contracts, or combining user-generated content with templates.

How Do You Compare PDF Merging Approaches?

Choosing the right merging strategy depends on your scenario. The table below summarizes the three main approaches:

Each approach shares the same Merge() method signature, so switching between strategies requires minimal code changes. The API reference documents every overload in detail.

How Do You Add Post-Merge Processing to Your PDF?

After merging, many workflows require additional document-level operations. IronPDF supports these through a clean, chainable API:

using IronPdf;
using IronPdf.Editing;

var pdf1 = PdfDocument.FromFile("Report-January.pdf");
var pdf2 = PdfDocument.FromFile("Report-February.pdf");

var merged = PdfDocument.Merge(pdf1, pdf2);

// Add a text-based header across all pages
var headerStamper = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align:right;font-size:10px;'>Quarterly Report</div>"
};
merged.AddHtmlHeadersAndFooters(headerStamper);

// Apply password protection
merged.SecuritySettings.UserPassword = "YourPassword";
merged.SecuritySettings.OwnerPassword = "OwnerSecret";

// Save the final, protected document
merged.SaveAs("QuarterlyReport_Protected.pdf");

using IronPdf;
using IronPdf.Editing;

var pdf1 = PdfDocument.FromFile("Report-January.pdf");
var pdf2 = PdfDocument.FromFile("Report-February.pdf");

var merged = PdfDocument.Merge(pdf1, pdf2);

// Add a text-based header across all pages
var headerStamper = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align:right;font-size:10px;'>Quarterly Report</div>"
};
merged.AddHtmlHeadersAndFooters(headerStamper);

// Apply password protection
merged.SecuritySettings.UserPassword = "YourPassword";
merged.SecuritySettings.OwnerPassword = "OwnerSecret";

// Save the final, protected document
merged.SaveAs("QuarterlyReport_Protected.pdf");

Imports IronPdf
Imports IronPdf.Editing

Dim pdf1 = PdfDocument.FromFile("Report-January.pdf")
Dim pdf2 = PdfDocument.FromFile("Report-February.pdf")

Dim merged = PdfDocument.Merge(pdf1, pdf2)

' Add a text-based header across all pages
Dim headerStamper As New HtmlHeaderFooter With {
    .HtmlFragment = "<div style='text-align:right;font-size:10px;'>Quarterly Report</div>"
}
merged.AddHtmlHeadersAndFooters(headerStamper)

' Apply password protection
merged.SecuritySettings.UserPassword = "YourPassword"
merged.SecuritySettings.OwnerPassword = "OwnerSecret"

' Save the final, protected document
merged.SaveAs("QuarterlyReport_Protected.pdf")

This pattern demonstrates how to layer post-processing steps on a single merged document object. The headers and footers API lets you apply consistent branding, while security settings protect sensitive documents from unauthorized access. You can also add digital signatures or apply PDF/A compliance in the same workflow.

What Are the Key Points for PDF Merging in .NET?

IronPDF transforms the task of merging PDF files in .NET into a process requiring minimal code. From simple two-file combinations to sophisticated multi-source document assembly, the library handles the technical complexity while providing an intuitive API. Whether you're working with a single file or processing large batches of documents, IronPDF maintains the integrity of the final document throughout the merge process.

The examples in this tutorial show how to integrate PDF merging capabilities into your .NET applications. Whether building document management systems, automating report generation, or processing user uploads, IronPDF provides the tools needed to combine PDF files efficiently from various input sources.

Ready to implement PDF merging in your project? Start with a free trial to explore IronPDF's full capabilities. For production deployments, explore the licensing options that best fit your needs. The complete documentation covers advanced features like adding watermarks, applying security, and splitting PDF documents.