Class PdfRenderingEngine

Specifies which HTML to PDF rendering engine to use for document generation. Chrome engine recommended for best compatibility and features.

// Use Chrome engine explicitly:
var renderer = new ChromePdfRenderer {
    RenderingOptions = new ChromePdfRenderOptions {
        RenderingEngine = PdfRenderingEngine.Chrome
    }
};

// Let IronPDF choose (defaults to Chrome):
Installation.RenderingEngine = PdfRenderingEngine.Default;

// Check current engine:
if (Installation.RenderingEngine == PdfRenderingEngine.Chrome) {
    // Using Chrome's advanced features
}

Chrome engine supports latest HTML5/CSS3/JavaScript

Chrome requires more memory but provides better results

See: https://ironpdf.com/how-to/html-to-pdf/

Inheritance

System.Object

PdfRenderingEngine

Namespace: IronPdf.Rendering

Assembly: IronPdf.dll

Syntax

public sealed class PdfRenderingEngine : Enum

The PdfRenderingEngine enumeration in IronPDF picks the HTML-to-PDF engine used for document generation.

Part of the IronPdf.Rendering namespace, declared values are Default and Chrome (2 total). Assign to Installation.RenderingEngine at app startup; Chrome requests Chromium for full HTML5, CSS3, and JavaScript support, while Default lets IronPDF pick the available engine (currently Chrome).

See HTML to PDF for typical C# usage.

Fields

Chrome

Chrome browser engine - full HTML5/CSS3/JavaScript support. RECOMMENDED: Most capable, multithreaded, standards compliant.

// Best quality rendering:
Installation.RenderingEngine = PdfRenderingEngine.Chrome;
var pdf = renderer.RenderHtmlAsPdf(modernHtml);

Supports flexbox, grid, modern JavaScript

Handles complex layouts and web fonts perfectly

Declaration

public const PdfRenderingEngine Chrome

Field Value

Type	Description
PdfRenderingEngine

Default

Automatic selection - chooses best available engine at runtime. Falls back to Chrome if available. Safe default choice.

Installation.RenderingEngine = PdfRenderingEngine.Default;

Declaration

public const PdfRenderingEngine Default

Field Value

Type	Description
PdfRenderingEngine

value__

Declaration

public int value__

Field Value

Type	Description
System.Int32