How to Convert Images to a PDF in C#

How Do I Convert a Single Image to PDF?

Use the ImageToPdf static method within the ImageToPdfConverter class to convert an image to a PDF document. This method requires only the file path to the image and converts it to a PDF document with default image placement and behavior. Supported image formats include .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp, and .pjpeg.

Before starting, ensure you have installed IronPDF via NuGet or downloaded the Windows installer. The library works seamlessly across Windows, macOS, and Linux platforms, making it versatile for various development environments.

What Image Formats Are Supported?

IronPDF supports a comprehensive range of image formats, including raster formats like JPEG, PNG, BMP, and GIF, as well as vector formats such as SVG graphics. The library handles both standard and modern formats like WebP and AVIF, ensuring compatibility with contemporary web applications. For specialized needs, work with icon files (.ico) and cursor files (.cur).

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image.cs

using IronPdf;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");

How Do I Convert Multiple Images to PDF?

To convert multiple images into a PDF document, provide an IEnumerable object containing file paths instead of a single file path. This generates a PDF document with default image placement and behavior.

When working with multiple images, consider the PDF compression options available to optimize file size without sacrificing quality. This is particularly important when creating large portfolios or photo albums.

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-multiple-images.cs

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

// Retrieve all JPG and JPEG image paths in the 'images' folder.
IEnumerable<String> imagePaths = Directory.EnumerateFiles("images").Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));

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

// Export the PDF
pdf.SaveAs("imagesToPdf.pdf");

How Can I Control Image Placement and Behaviors?

IronPDF offers various image placement and behavior options. You can center the image on the page or fit it to the page size while maintaining its aspect ratio. All available image placements and behaviors are:

• TopLeftCornerOfPage: Image is placed at the top-left corner of the page.
• TopRightCornerOfPage: Image is placed at the top-right corner of the page.
• CenteredOnPage: Image is centered on the page.
• FitToPageAndMaintainAspectRatio: Image fits the page while keeping its original aspect ratio.
• BottomLeftCornerOfPage: Image is placed at the bottom-left corner of the page.
• BottomRightCornerOfPage: Image is placed at the bottom-right corner of the page.
• FitToPage: Image fits the page.
• CropPage: Page is adjusted to fit the image.

These placement options work seamlessly with IronPDF's page orientation and rotation features, allowing you to create professional-looking documents regardless of your image dimensions.

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-image-behavior.cs

using IronPdf;
using IronPdf.Imaging;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF with image behavior of centered on page
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");

What Are the Visual Differences Between Image Behaviors?

TopLeftCornerOfPage	TopRightCornerOfPage
CenteredOnPage	FitToPageAndMaintainAspectRatio
BottomLeftCornerOfPage	BottomRightCornerOfPage
FitToPage	CropPage

---

How Do I Customize PDF Rendering Options?

The ImageToPdf static method converts images by importing them as HTML <img> tags and then converting the HTML to PDF. This allows you to pass the ChromePdfRenderOptions object as a third parameter to customize the rendering process directly.

This approach provides access to all the powerful rendering options available in IronPDF, including JavaScript execution, CSS media types, and viewport configuration. You can even incorporate web fonts and icons to enhance your document's visual appeal.

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-rendering-options.cs

using IronPdf;

string imagePath = "meetOurTeam.jpg";

ChromePdfRenderOptions options = new ChromePdfRenderOptions()
{
    HtmlHeader = new HtmlHeaderFooter()
    {
        HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
        DrawDividerLine = true,
    },
};

// Convert an image to a PDF with custom header
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, options: options);

// Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf");