Convert JPEG to PDF .NET | IronPDF C# Tutorial

How Do You Install IronPDF for JPEG to PDF Conversion?

Before writing any conversion code, add IronPDF to your .NET project. The library is distributed through NuGet and installs in seconds.

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 targets .NET 8, .NET 9, and .NET 10, as well as .NET Framework 4.6.2 and later. No additional runtime dependencies are required -- the package includes everything needed for image-to-PDF conversion on Windows, Linux, macOS, Docker, and Azure.

Once installed, add a single using IronPdf; statement at the top of your file and you are ready to start converting.

The IronPDF NuGet package bundles the rendering engine, so there is no separate installer for production servers. For cloud deployments, review the Docker setup guide to configure the correct base image.

How Do You Convert a Single JPEG Image to PDF in C#?

The simplest path to JPEG-to-PDF conversion uses the ImageToPdfConverter.ImageToPdf() static method. Pass the image file path, receive a PdfDocument object, and save it wherever you need.

using IronPdf;

// Convert a single JPG image to PDF
string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Save the converted PDF file
pdf.SaveAs("converted-photo.pdf");

using IronPdf;

// Convert a single JPG image to PDF
string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Save the converted PDF file
pdf.SaveAs("converted-photo.pdf");

The ImageToPdf method accepts the file path to your JPEG file and returns a PdfDocument object that you can save, stream, or pass to other IronPDF operations. The conversion happens in memory, which makes it ideal for web applications that need to serve the PDF directly without touching disk.

The output PDF maintains the original image quality while packaging it into a format that any PDF reader can open. Page sizing is handled automatically -- the PDF page dimensions match the image dimensions by default, giving you a clean output with no white borders unless you request them. If you need specific margins, use the custom margins API.

For developers already familiar with HTML to PDF conversion, the image conversion API follows the same pattern: provide input, configure options if needed, and save the output.

using IronPdf;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Get the PDF as a byte array for streaming
byte[] pdfBytes = pdf.BinaryData;

// In an ASP.NET Core controller:
// return File(pdfBytes, "application/pdf", "converted.pdf");

using IronPdf;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Get the PDF as a byte array for streaming
byte[] pdfBytes = pdf.BinaryData;

// In an ASP.NET Core controller:
// return File(pdfBytes, "application/pdf", "converted.pdf");

How Do You Convert Multiple JPEG Files into One PDF Document?

Batch conversion -- taking several JPEG images and combining them into a single PDF -- is equally straightforward. Pass an enumerable of file paths to ImageToPdfConverter.ImageToPdf() and the library places each image on its own page in the output.

using IronPdf;
using System.IO;
using System.Linq;

// Gather all JPG files from a folder
var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase)
             || f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase));

// Convert multiple JPEG images to a single PDF file
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePaths);

// Save the combined PDF
pdf.SaveAs("photo-collection.pdf");

using IronPdf;
using System.IO;
using System.Linq;

// Gather all JPG files from a folder
var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase)
             || f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase));

// Convert multiple JPEG images to a single PDF file
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePaths);

// Save the combined PDF
pdf.SaveAs("photo-collection.pdf");

The images appear in the PDF in the same order they appear in the enumerable. To control page order, sort the file paths before passing them to the converter -- for example, by filename, creation date, or any custom ordering that fits your workflow.

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

var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase));

var pdfDocuments = new List<PdfDocument>();

foreach (var imagePath in imagePaths)
{
    var individualPdf = ImageToPdfConverter.ImageToPdf(
        imagePath,
        ImageBehavior.FitToPageAndMaintainAspectRatio
    );
    pdfDocuments.Add(individualPdf);
}

// Merge all individual PDFs into one document
PdfDocument combinedPdf = PdfDocument.Merge(pdfDocuments);
combinedPdf.SaveAs("custom-photo-collection.pdf");

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

var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase));

var pdfDocuments = new List<PdfDocument>();

foreach (var imagePath in imagePaths)
{
    var individualPdf = ImageToPdfConverter.ImageToPdf(
        imagePath,
        ImageBehavior.FitToPageAndMaintainAspectRatio
    );
    pdfDocuments.Add(individualPdf);
}

// Merge all individual PDFs into one document
PdfDocument combinedPdf = PdfDocument.Merge(pdfDocuments);
combinedPdf.SaveAs("custom-photo-collection.pdf");

What Image Formats Does This PDF Converter Support?

IronPDF's image-to-PDF converter handles a broad range of formats beyond JPEG. The same ImageToPdfConverter class processes PNG, BMP, GIF, TIFF, SVG, and WebP files using identical method calls -- you do not need separate code paths for different image types.

For TIFF files specifically, IronPDF supports multi-frame TIFF to PDF conversion, where each frame in the TIFF becomes a separate page in the output PDF. This is particularly useful for scanned multi-page documents that arrive as TIFF archives.

Beyond static raster images, IronPDF also processes SVG vector graphics at full resolution, making it a reliable tool for converting technical diagrams and icons without quality loss. The same engine that handles images also renders HTML to PDF, so mixed content pipelines -- documents containing both images and HTML-formatted text -- are well supported.

Unlike browser-based or online PDF converters, IronPDF runs entirely within your .NET process. Files never leave your server, which matters for applications handling confidential documents, medical images, or financial records.

How Do You Control Image Placement in the Converted PDF?

By default, IronPDF sizes the PDF page to match the image dimensions. If you need different behavior -- fitting images to a standard paper size, centering them with white margins, or cropping to fill the page -- use the ImageBehavior enum combined with ImageToPdfRenderOptions.

using IronPdf;

var renderingOptions = new ImageToPdfRenderOptions
{
    ImageBehavior = ImageBehavior.FitToPageAndMaintainAspectRatio,
    PaperSize = PdfPaperSize.A4,
    MarginTop = 25,
    MarginBottom = 25,
    MarginLeft = 25,
    MarginRight = 25
};

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, renderingOptions);
pdf.SaveAs("formatted-output.pdf");

using IronPdf;

var renderingOptions = new ImageToPdfRenderOptions
{
    ImageBehavior = ImageBehavior.FitToPageAndMaintainAspectRatio,
    PaperSize = PdfPaperSize.A4,
    MarginTop = 25,
    MarginBottom = 25,
    MarginLeft = 25,
    MarginRight = 25
};

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, renderingOptions);
pdf.SaveAs("formatted-output.pdf");

The available ImageBehavior values cover the most common layout requirements:

• FitToPageAndMaintainAspectRatio -- scales the image to fill the page while preserving proportions
• CenteredOnPage -- places the image at its original size, centered horizontally and vertically
• TopLeftCornerOfPage -- anchors the image to the top-left without scaling
• CropPage -- trims the page size to match the image dimensions exactly

After conversion, you can apply additional transformations. Add a watermark using HTML markup, attach headers and footers for document identification, or rotate pages to match the desired orientation.

Further post-processing options include:

• Stamping text or images for branding or approval marks
• Applying background templates for letterhead effects
• Compressing the output PDF to reduce file size for email or upload
• Drawing shapes and annotations for visual markup

What Are the Most Common Use Cases for JPEG to PDF Conversion?

Programmatic JPEG-to-PDF conversion is a building block for many document workflows. Understanding the most frequent scenarios helps you design the right architecture for your application.

Document archival and compliance -- Organizations that scan paper records produce JPEG files from flatbed and document scanners. Converting these to PDF allows indexing, long-term storage in PDF/A format, and access through standard document management platforms. PDF/A is an ISO standard specifically designed for archival, and IronPDF supports generating compliant files.

Report and dashboard generation -- Applications that generate charts, screenshots, or data visualizations often capture output as JPEG. Embedding these into PDF reports using ImageToPdfConverter produces consistent, printable documents that stakeholders can review without installing charting software.

Photo portfolios and galleries -- Creative professionals and real estate platforms use batch JPEG-to-PDF conversion to produce printable property sheets, portfolio books, and catalog PDFs. Combining dozens of photos into a single navigable PDF with bookmarks creates a better presentation than a folder of image files.

Automated upload workflows -- Web applications that accept JPEG uploads from users -- profile photos, supporting documents, ID scans -- can normalize all uploads to PDF for consistent downstream processing. This simplifies storage, search, and rendering because the application deals with one format instead of many.

According to the PDF Association's industry research, PDF remains the most widely used document format in enterprise environments, which is why converting images to PDF early in a workflow pays dividends in compatibility and long-term accessibility.

The Mozilla Developer Network documents the PDF MIME type as application/pdf, which is natively supported by all major browsers without plugins -- making PDF the safest format choice for documents that need to be viewed in a browser.

For enhanced security in any of these scenarios, IronPDF supports PDF redaction to permanently remove sensitive content, PDF sanitization to strip hidden metadata, and digital signatures for document authentication.

How Do You Add Headers, Footers, and Metadata to Converted PDFs?

A converted JPEG-to-PDF is often just the starting point. Production applications typically need to add document metadata, page numbers, and organizational branding before delivering the final file.

using IronPdf;
using IronPdf.Editing;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Add a text footer with page numbers
var footer = new TextHeaderFooter
{
    CenterText = "Page {page} of {total-pages}",
    DrawDividerLine = true,
    FontSize = 10
};
pdf.AddTextFooters(footer);

// Set document metadata
pdf.MetaData.Title = "Converted Photo Document";
pdf.MetaData.Author = "Document Processing System";
pdf.MetaData.CreationDate = System.DateTime.Now;

// Apply a confidentiality watermark if needed
pdf.ApplyWatermark(
    "<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30,
    VerticalAlignment.Middle,
    HorizontalAlignment.Center
);

pdf.SaveAs("final-document.pdf");

using IronPdf;
using IronPdf.Editing;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Add a text footer with page numbers
var footer = new TextHeaderFooter
{
    CenterText = "Page {page} of {total-pages}",
    DrawDividerLine = true,
    FontSize = 10
};
pdf.AddTextFooters(footer);

// Set document metadata
pdf.MetaData.Title = "Converted Photo Document";
pdf.MetaData.Author = "Document Processing System";
pdf.MetaData.CreationDate = System.DateTime.Now;

// Apply a confidentiality watermark if needed
pdf.ApplyWatermark(
    "<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30,
    VerticalAlignment.Middle,
    HorizontalAlignment.Center
);

pdf.SaveAs("final-document.pdf");

For batch conversions, you can apply the same footer and metadata to every page in a multi-image PDF before saving. The async processing API allows high-throughput environments to process many images concurrently without blocking threads.

If your deployment is cloud-based, review the Azure deployment guide and AWS setup documentation for environment-specific configuration. The custom logging API integrates with Serilog, NLog, and Microsoft.Extensions.Logging for operational monitoring.

The IronPDF troubleshooting guide covers the most common issues that arise in production, including font loading, permission errors on Linux, and rendering differences across .NET versions.

What Are Your Next Steps?

IronPDF's ImageToPdfConverter class gives you a straightforward path from JPEG files to professional PDF documents in C#. The API handles single images and batch collections with the same method call, supports seven image formats without additional code, and integrates with the full range of IronPDF's PDF manipulation features.

Start by installing the package via NuGet:

Install-Package IronPdf

Install-Package IronPdf

Then adapt the code examples from this tutorial to your use case. Single-image conversion works with three lines of code. Batch processing needs a LINQ query and one method call. Layout customization uses the ImageToPdfRenderOptions class with the ImageBehavior enum.

The IronPDF free trial gives you full access to all features for evaluation. When you are ready for production, review the licensing options for commercial applications, including the licensing upgrade paths for growing teams. The IronPDF PDF converter features page lists every supported conversion type if you need to handle more than just JPEG input.

For related image-to-document workflows, the add images to PDFs guide covers embedding images into existing PDF pages, and the HTML to PDF tutorial explains how to generate PDFs from HTML templates that combine text and images in a single document.