How to Set Page Orientation & Rotation in .NET C#

When Should I Use Landscape Orientation?

Landscape orientation is ideal for content that requires more horizontal space, such as wide tables, charts, dashboards, or presentations. When you're converting HTML files to PDF, landscape mode ensures that wide content displays correctly without unwanted text wrapping or element overflow. This orientation is particularly useful for reports containing financial data, project timelines, or any content designed for widescreen viewing.

:path=/static-assets/pdf/content-code-examples/how-to/page-orientation-rotation-orientation.cs

using IronPdf;
using IronPdf.Rendering;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Change paper orientation
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;

PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

pdf.SaveAs("landscape.pdf");

The ChromePdfRenderer class offers additional flexibility when setting orientation. You can also specify custom paper sizes alongside orientation settings to create PDFs that meet exact specifications. This is particularly valuable when creating documents for specialized printing requirements or unique display formats.

What Does the Landscape Output Look Like?

Which Methods Should I Use to Rotate Pages?

Use the methods below to set the rotation for a single page, multiple pages, or all pages.

• SetAllPageRotations: Sets the rotation degree for all pages.
• SetPageRotation: Sets the rotation degree for a single page.
• SetPageRotations: Sets the rotation degree for a selected list of pages.

IronPDF's rotation methods work seamlessly with other page manipulation features. You can combine rotation with other transform operations to achieve complex document layouts, or use them alongside methods for rotating text and pages to create sophisticated document structures.

:path=/static-assets/pdf/content-code-examples/how-to/page-orientation-rotation-set-rotation.cs

using IronPdf;
using IronPdf.Rendering;
using System.Collections.Generic;

PdfDocument pdf = PdfDocument.FromFile("landscape.pdf");

// Set all pages
pdf.SetAllPageRotations(PdfPageRotation.Clockwise90);

// Set a single page
pdf.SetPageRotation(1, PdfPageRotation.Clockwise180);

// Set multiple pages
List<int> selectedPages = new List<int>() { 0, 3 };
pdf.SetPageRotations(selectedPages, PdfPageRotation.Clockwise270);

pdf.SaveAs("rotatedLandscape.pdf");

When working with rotation, it's important to understand that the operation affects the entire page content, including text, images, and any annotations. This differs from text-specific rotation, which only affects individual text elements. For more granular control over document layout, explore the comprehensive PDF creation tutorial that covers advanced formatting techniques.

What Does the Rotated PDF Look Like?

How Can I Check the Current Page Rotation?

Use the GetPageRotation method to retrieve the rotation of any particular page in the PDF document. Simply supply the page index to the method.

This method is particularly useful when processing documents with mixed orientations or when you need to maintain consistent rotation across merged documents. The ability to query current rotation states enables intelligent document processing workflows, especially when combined with other page orientation examples.

:path=/static-assets/pdf/content-code-examples/how-to/page-orientation-rotation-get-rotation.cs

using IronPdf;
using IronPdf.Rendering;

PdfDocument pdf = PdfDocument.FromFile("rotatedLandscape.pdf");

PdfPageRotation rotation = pdf.GetPageRotation(1);