How to Render PDFs with Custom Paper Size
A custom paper size refers to a non-standard paper size that is defined by the user rather than being a standard size like A4 or letter size (8.5 x 11 inches). Custom paper sizes are often used when printing documents that require a unique or specific layout, such as posters, banners, or specialty documents.
Discover the extensive range of paper sizes available with IronPDF, offering a wide selection to suit your needs!
How to Render PDFs with Custom Paper Size
- Download the C# library to set a custom paper size
- Instantiate the ChromePdfRenderer class in C#
- Access the RenderingOptions on the new object
- invoke one of the
SetCustomPaperSizemethods based on the measurement unit - Render and export the PDF document
Install with NuGet
Install-Package IronPdf
Install with NuGet
Install-Package IronPdf
Start using IronPDF in your project today with a free trial.
Check out IronPDF on Nuget for quick installation and deployment. With over 8 million downloads, it's transforming PDF with C#.
Consider installing the IronPDF DLL directly. Download and manually install it for your project or GAC form: IronPdf.zip
Use Custom Paper Size Example
First, we begin by instantiating the ChromePdfRenderer class. From the newly created object, we can access the RenderingOptions to apply a custom paper size to the newly generated PDF document. There are four methods that can be used to set the output paper size for PDF pages, each based on a different measurement unit:
SetCustomPaperSizeInCentimeters: Dimensions are in centimeters.SetCustomPaperSizeInInches: Dimensions are in inches.SetCustomPaperSizeInMillimeters: Dimensions are in millimeters.SetCustomPaperSizeInPixelsOrPoints: Dimensions are in pixels or points.
Code
:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-cm.csusing IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
// Set custom paper size in cm
renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15);
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Custom Paper Size</h1>");
pdf.SaveAs("customPaperSize.pdf");Imports IronPdf
Private renderer As New ChromePdfRenderer()
' Set custom paper size in cm
renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15)
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Custom Paper Size</h1>")
pdf.SaveAs("customPaperSize.pdf")Output PDF
Related Properties
- PaperSize: Set an output paper size for PDF pages with predefined sizes such as letter, A3, A4, etc.
- ForcePaperSize: Forces page sizes to be exactly what is specified via IronPdf.ChromePdfRenderOptions.PaperSize by resizing the page after generating a PDF from HTML. This feature is useful for bypassing CSS rules that specify paper size.
Modify Paper Dimension Example
In an existing PDF document or a freshly rendered PDF, the size of each page can be modified using the ExtendPage method. This method allows you to specify the target page index, the values to modify each of the four sides, and the units of measurement. The values for each side can be negative, which will reduce that particular side, or positive, which will extend that side.
Code
:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-modify-paper-size.csusing IronPdf;
using IronPdf.Editing;
PdfDocument pdf = PdfDocument.FromFile("customPaperSize.pdf");
pdf.ExtendPage(0, 50, 0, 0, 0, MeasurementUnit.Millimeter);
pdf.SaveAs( "extendedLeftSide.pdf");Imports IronPdf
Imports IronPdf.Editing
Private pdf As PdfDocument = PdfDocument.FromFile("customPaperSize.pdf")
pdf.ExtendPage(0, 50, 0, 0, 0, MeasurementUnit.Millimeter)
pdf.SaveAs("extendedLeftSide.pdf")Output PDF
