Chrome PDF Rendering Engine

Create high-grade PDF renders utilizing the PDF-rendering engine of Chrome!

Chromium is an open-source web browser project developed and maintained by Google. It serves as the foundation for several popular web browsers, including Google Chrome, Microsoft Edge, Opera, and many others.

Install with NuGet

Install-Package IronPdf

nuget.org/packages/IronPdf/

or

Download DLL

Download DLL

Manually install into your project

High-Quality Improvements, Well Tested

High-Quality Rendering

The latest “Blink!” HTML rendering. Choose from Chrome Identical rendering or Enhanced Rendering (which we find more accurate and easy to code for than Chrome.)

20% Faster Renders

Provides effortless multithreading and Async, using as many CPU cores as you wish. For SAAS and high-load applications this may be 5-20 times faster, outperforming direct browser usage and web-drivers.

Full Support

Full (and we mean full) support for JavaScript, responsive layout and CSS3.
Azure as a first class citizen. It just works.
Continued maintenance and improved full support for .NET 8, 7, 6, 5, Core, and Framework 4.6.2+.

Rigorously Tested

The release passed with 1156 green unit & integration tests (and no red ones). We believe this EAP to be as stable as our main release, and has our best minds actively improving it every day.

Section 508 Accessibility Compliance

Produces accessible PDFs using the PDF(UA) tagged PDF standard.

Ongoing Improvements

We would love to hear your feedback. Contact sales@ironsoftware.com with ideas or if you need any help getting things running.

Implement in Your Project

1. Install IronPDF

First you must install IronPDF into your project from the NuGet Package Manager named IronPdf.

Install-Package IronPdf

2. Try the new API

We haven’t broken the previous IronPDF C# and VB.NET API you are already using. It will remain! However, the old style is being superseded by a better one to give you more control.

For example, you now have RenderingOptions and HttpLoginCredentials specific to your renderer.

:path=/static-assets/pdf/content-code-examples/how-to/ironpdf-2021-chrome-rendering-engine-eap-new-api.cs

using IronPdf;

// Instantiate renderer class
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Apply rendering options
renderer.RenderingOptions.PaperFit.UseFitToPageRendering();
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

// Render to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!</h1>");
// PdfDocument pdf = Renderer.RenderUrlAsPdf("https://www.google.com/");
// PdfDocument pdf = Renderer.RenderHtmlFileAsPdf("example.html");
pdf.SaveAs("google_chrome.pdf");

Imports IronPdf

' Instantiate renderer class
Private renderer As New ChromePdfRenderer()

' Apply rendering options
renderer.RenderingOptions.PaperFit.UseFitToPageRendering()
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.CreatePdfFormsFromHtml = True

' Render to PDF
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello world!</h1>")
' PdfDocument pdf = Renderer.RenderUrlAsPdf("https://www.google.com/");
' PdfDocument pdf = Renderer.RenderHtmlFileAsPdf("example.html");
pdf.SaveAs("google_chrome.pdf")

3. Apply Pixel-Perfect Chrome Rendering

This example will give you PDFs that are pixel-perfect to the latest Chrome desktop browser’s “print to PDF” functionality.

:path=/static-assets/pdf/content-code-examples/how-to/ironpdf-2021-chrome-rendering-engine-eap-pixel-perfect.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
renderer.RenderingOptions.PrintHtmlBackgrounds = false;
renderer.RenderingOptions.CreatePdfFormsFromHtml = false;

PdfDocument pdf = renderer.RenderUrlAsPdf("https://www.google.com/");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
renderer.RenderingOptions.PrintHtmlBackgrounds = False
renderer.RenderingOptions.CreatePdfFormsFromHtml = False

Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://www.google.com/")

Recommended Improvements

We recommend using some Iron-specific improvements.

• Use screen stylesheets to print PDFs. They are less fiddly to develop and more true to existing web assets.
• Responsive layout support.
• Create PDF Forms from your HTML form elements.

:path=/static-assets/pdf/content-code-examples/how-to/ironpdf-2021-chrome-rendering-engine-eap-recommended.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;
renderer.RenderingOptions.ViewPortWidth = 1080;  //pixels

PdfDocument pdf = renderer.RenderUrlAsPdf("https://www.google.com/");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.CreatePdfFormsFromHtml = True
renderer.RenderingOptions.ViewPortWidth = 1080 'pixels

Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://www.google.com/")

4. Multi-threading and Async Support

Multithreading and Async support for our Chrome rendering engine is in a different league to the previous build.

• For enterprise grade multithreading, use our ChromePdfRenderer in your existing threads and it will work. For web applications this also takes zero setup.
• For batch processing of HTML to PDF, we recommend using the built in .NET Parallel.ForEach pattern.
• We love async and have provided Async variants of all of our rendering methods methods such as ChromePdfRenderer.RenderHtmlAsPdfAsync

5. What is next?

Features Coming Soon

• Ultra-Slim deployments, useful for Azure functions and AWS Lambda. We aim to provide deployment options to produce the smallest possible disk footprint.
• Mobile rendering support: support for iOS and Android app developers.
• IE and Firefox rendering options.
• Multi-server distributed rendering architectures for large enterprise users.
• A re-imagined internal PDF document object model to support the widest range of PDF standards. We want to be able to handle reading and automatically fixing corrupted and badly encoded PDF documents elegantly.
• "{YourIdeaHere}" Feature requests and bug reports our customers go to the top of the stack.

Please Contact Us with any suggestions or questions.