Add Header and Footer in PDF Using iTextSharp and IronPDF in C# with Example

Adding Headers and Footers to PDF Documents in C

Adding headers and footers to PDF documents is essential for creating professional reports, invoices, and business documents. Developers searching for iTextSharp solutions using PdfPageEventHelper and the OnEndPage method will find that modern .NET libraries offer significantly simpler approaches to achieve the same results.

This guide demonstrates how to add headers and footers in PDF files using C#, comparing the traditional iText 7 approach with IronPDF's concise API. By the end, you will understand both implementations -- from creating a new Document to generating the final PDF file -- and can choose the approach that best fits your project requirements.

Why Do PDF Headers and Footers Matter in Professional Documents?

Headers and footers serve critical functions in professional PDF documents. They provide consistent branding through image logos, enable page navigation with page numbers, display important metadata like dates and document titles, and establish document authenticity through timestamps and version information.

In enterprise environments, headers and footers often carry legal significance. Financial reports require timestamps for audit trails. Contracts need page numbering to ensure completeness. Internal documents may require confidentiality notices on every page. Meeting these requirements programmatically requires a PDF library that reliably handles page-level content injection.

Key reasons to add headers and footers programmatically include:

• Audit compliance -- timestamps and version numbers on every page satisfy regulatory requirements
• Brand consistency -- company logos and styling applied uniformly across all generated documents
• Navigation -- page numbers and section titles help readers locate information quickly
• Authenticity -- author name, creation date, and document ID prevent disputes over document integrity

How Do You Add a Text Header and Footer in C#?

IronPDF provides the most direct approach for adding headers and footers to PDF documents in .NET applications. Using the ChromePdfRenderer class combined with either TextHeaderFooter or HtmlHeaderFooter, you can generate headers and footers with minimal code -- no need to create separate cells or manage a contentbyte object manually.

Before writing any code, add IronPDF to your project using NuGet:

Install-Package IronPdf
dotnet add package IronPdf

Install-Package IronPdf
dotnet add package IronPdf

The library requires no external dependencies and works immediately after installation. It targets .NET 5, 6, 7, 8, and 10, and runs on Windows, Linux, and macOS without platform-specific configuration.

In older iTextSharp patterns, developers created helper methods such as private static void AddContent() to manually inject header and footer logic. IronPDF eliminates the need for such boilerplate entirely.

Here is a complete example that adds both a text header and a footer to a PDF file:

using IronPdf;

// Initialize the PDF renderer
var renderer = new ChromePdfRenderer();

// Configure the text header
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
    CenterText = "Quarterly Sales Report",
    DrawDividerLine = true,
    FontSize = 14
};

// Configure the text footer with page number and date
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
    LeftText = "{date}",
    RightText = "Page {page} of {total-pages}",
    DrawDividerLine = true,
    FontSize = 10
};

// Set margins to accommodate header and footer
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;

// Generate PDF from HTML content
var pdf = renderer.RenderHtmlAsPdf("<h1>Sales Data</h1><p>Content goes here...</p>");
pdf.SaveAs("report-with-headers.pdf");

using IronPdf;

// Initialize the PDF renderer
var renderer = new ChromePdfRenderer();

// Configure the text header
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
    CenterText = "Quarterly Sales Report",
    DrawDividerLine = true,
    FontSize = 14
};

// Configure the text footer with page number and date
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
    LeftText = "{date}",
    RightText = "Page {page} of {total-pages}",
    DrawDividerLine = true,
    FontSize = 10
};

// Set margins to accommodate header and footer
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;

// Generate PDF from HTML content
var pdf = renderer.RenderHtmlAsPdf("<h1>Sales Data</h1><p>Content goes here...</p>");
pdf.SaveAs("report-with-headers.pdf");

The TextHeaderFooter class provides properties for positioning text on the left, center, or right of the header or footer area. The DrawDividerLine property adds a professional separator line between the header or footer and the main document content. Mergeable fields like {page}, {total-pages}, and {date} automatically populate with dynamic values during PDF generation.

IronPDF handles margin calculations automatically, ensuring headers and footers do not overlap with your document content. The TextHeaderFooter class supports font types from IronSoftware.Drawing.FontTypes, giving you control over typography without external dependencies.

How Do You Create HTML-Styled Headers and Footers?

For more sophisticated designs, IronPDF's HtmlHeaderFooter class enables full HTML and CSS styling. This approach is particularly valuable when headers need to include an image logo, complex layouts, or brand-specific styling -- without manually creating PdfPCell objects or using new Phrase constructors.

using IronPdf;
using System;

var renderer = new ChromePdfRenderer();

// Create an HTML header with logo and styling
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = @"
        <div style='width: 100%; font-family: Arial, sans-serif;'>
            <img src='logo.png' style='height: 30px; float: left;' />
            <span style='float: right; font-size: 12px; color: #666;'>
                Confidential Document
            </span>
        </div>",
    MaxHeight = 25,
    DrawDividerLine = true,
    BaseUrl = new Uri(@"C:\assets\").AbsoluteUri
};

// Create an HTML footer with page numbering
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = @"
        <div style='text-align: center; font-size: 10px; color: #999;'>
            <span>Generated on {date} at {time}</span>
            <br/>
            <span>Page {page} of {total-pages}</span>
        </div>",
    MaxHeight = 20
};

renderer.RenderingOptions.MarginTop = 30;
renderer.RenderingOptions.MarginBottom = 25;

var pdf = renderer.RenderHtmlAsPdf("<h1>Project Proposal</h1><p>Document content...</p>");
pdf.SaveAs("styled-document.pdf");

using IronPdf;
using System;

var renderer = new ChromePdfRenderer();

// Create an HTML header with logo and styling
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = @"
        <div style='width: 100%; font-family: Arial, sans-serif;'>
            <img src='logo.png' style='height: 30px; float: left;' />
            <span style='float: right; font-size: 12px; color: #666;'>
                Confidential Document
            </span>
        </div>",
    MaxHeight = 25,
    DrawDividerLine = true,
    BaseUrl = new Uri(@"C:\assets\").AbsoluteUri
};

// Create an HTML footer with page numbering
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = @"
        <div style='text-align: center; font-size: 10px; color: #999;'>
            <span>Generated on {date} at {time}</span>
            <br/>
            <span>Page {page} of {total-pages}</span>
        </div>",
    MaxHeight = 20
};

renderer.RenderingOptions.MarginTop = 30;
renderer.RenderingOptions.MarginBottom = 25;

var pdf = renderer.RenderHtmlAsPdf("<h1>Project Proposal</h1><p>Document content...</p>");
pdf.SaveAs("styled-document.pdf");

This sample code showcases how HTML headers can incorporate images alongside text. The BaseUrl property establishes the root path for resolving relative image URLs, making it simple to include company logos or other graphics. The MaxHeight property ensures the header does not exceed specified dimensions, maintaining consistent document layouts.

The mergeable fields ({page}, {total-pages}, {url}, {date}, {time}, {html-title}, {pdf-title}) work identically in HTML headers and footers, providing dynamic content insertion without additional code. For guidance on implementing various header styles, see the Headers and Footers How-To Guide.

The HTML approach shines when creating branded documents. Marketing teams can provide HTML templates that developers integrate directly, ensuring pixel-perfect reproduction of approved designs. CSS properties like font-family, color, background-color, and border work as expected, enabling sophisticated visual treatments that would require extensive low-level code in other libraries.

How Can You Add Headers to Existing PDF Documents?

A common requirement involves adding headers and footers to PDF files that already exist -- whether they are uploaded documents, merged files, or PDFs generated by other systems. IronPDF handles this scenario with the AddHtmlHeaders and AddHtmlFooters methods.

using IronPdf;

// Load an existing PDF document
var pdf = PdfDocument.FromFile("customer-profile.pdf");

// Define the header to add
var header = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align: center;'>REVISED COPY - {date}</div>",
    MaxHeight = 20
};

// Define the footer to add
var footer = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align: right;'>Page {page}</div>",
    MaxHeight = 15
};

// Apply headers and footers to all pages
pdf.AddHtmlHeaders(header);
pdf.AddHtmlFooters(footer);
pdf.SaveAs("document-with-new-headers.pdf");

using IronPdf;

// Load an existing PDF document
var pdf = PdfDocument.FromFile("customer-profile.pdf");

// Define the header to add
var header = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align: center;'>REVISED COPY - {date}</div>",
    MaxHeight = 20
};

// Define the footer to add
var footer = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align: right;'>Page {page}</div>",
    MaxHeight = 15
};

// Apply headers and footers to all pages
pdf.AddHtmlHeaders(header);
pdf.AddHtmlFooters(footer);
pdf.SaveAs("document-with-new-headers.pdf");

The PdfDocument class represents a loaded or rendered PDF and provides methods for post-rendering modifications. This separation between rendering and modification enables workflows where PDF documents pass through multiple processing stages. The AddHtmlHeaders method automatically applies the header to every page, though you can also target specific pages by passing a collection of page indices.

How Do You Add Different Headers on Different Pages?

Some documents require the first page to have a different header (or no header at all), while subsequent pages use a standard format. IronPDF supports this through page-index-based header application -- no need to check conditions inside void OnEndPage handlers or manage loop counters manually:

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

var renderer = new ChromePdfRenderer();

// Build multi-page HTML with print page-breaks between pages
var pages = new List<string>
{
    "<section><h1>Title Page</h1><p>Intro text on page 1.</p></section>",
    "<section><h2>Report</h2><p>Detailed report content on page 2.</p></section>",
    "<section><h2>Appendix</h2><p>Appendix content on page 3.</p></section>"
};

var sb = new StringBuilder();
sb.AppendLine("<!doctype html><html><head><meta charset='utf-8'>");
sb.AppendLine("<style>");
sb.AppendLine("  body { font-family: Arial, sans-serif; margin: 20px; }");
sb.AppendLine("  .page-break { page-break-after: always; }");
sb.AppendLine("</style>");
sb.AppendLine("</head><body>");

for (int i = 0; i < pages.Count; i++)
{
    sb.AppendLine(pages[i]);
    if (i < pages.Count - 1)
        sb.AppendLine("<div class='page-break'></div>");
}
sb.AppendLine("</body></html>");

var pdf = renderer.RenderHtmlAsPdf(sb.ToString());

// Create the standard header for pages 2 onwards
var standardHeader = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align: center;'>Standard Header - Page {page}</div>",
    MaxHeight = 20
};

// Apply to all pages except the first (index 0)
var pageIndices = Enumerable.Range(1, pdf.PageCount - 1).ToList();
pdf.AddHtmlHeaders(standardHeader, 1, pageIndices);
pdf.SaveAs("document-skip-first-page-header.pdf");

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

var renderer = new ChromePdfRenderer();

// Build multi-page HTML with print page-breaks between pages
var pages = new List<string>
{
    "<section><h1>Title Page</h1><p>Intro text on page 1.</p></section>",
    "<section><h2>Report</h2><p>Detailed report content on page 2.</p></section>",
    "<section><h2>Appendix</h2><p>Appendix content on page 3.</p></section>"
};

var sb = new StringBuilder();
sb.AppendLine("<!doctype html><html><head><meta charset='utf-8'>");
sb.AppendLine("<style>");
sb.AppendLine("  body { font-family: Arial, sans-serif; margin: 20px; }");
sb.AppendLine("  .page-break { page-break-after: always; }");
sb.AppendLine("</style>");
sb.AppendLine("</head><body>");

for (int i = 0; i < pages.Count; i++)
{
    sb.AppendLine(pages[i]);
    if (i < pages.Count - 1)
        sb.AppendLine("<div class='page-break'></div>");
}
sb.AppendLine("</body></html>");

var pdf = renderer.RenderHtmlAsPdf(sb.ToString());

// Create the standard header for pages 2 onwards
var standardHeader = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align: center;'>Standard Header - Page {page}</div>",
    MaxHeight = 20
};

// Apply to all pages except the first (index 0)
var pageIndices = Enumerable.Range(1, pdf.PageCount - 1).ToList();
pdf.AddHtmlHeaders(standardHeader, 1, pageIndices);
pdf.SaveAs("document-skip-first-page-header.pdf");

The second parameter in AddHtmlHeaders specifies the starting page number for the {page} mergeable field, while the third parameter accepts a collection of page indices to receive the header. This granular control enables complex document layouts without convoluted conditional logic. The Advanced Headers and Footers example covers additional scenarios, including odd/even page differentiation.

How Do You Implement Dynamic Content Beyond Page Numbers?

The mergeable fields system supports several dynamic values that automatically populate during rendering. The following table lists all available fields and their meanings:

For truly dynamic content -- values determined at runtime -- you can construct the HTML fragment string with interpolated values before assigning it to the HtmlFragment property. This approach enables headers that include database-retrieved values, user information, or calculated data:

using IronPdf;

string userName = GetCurrentUserName();
string documentVersion = "v2.3.1";

var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = $"<div style='font-size:10px;'>Prepared by: {userName} " +
                   $"| Version: {documentVersion} " +
                   "| Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

var pdf = renderer.RenderHtmlAsPdf("<h1>Annual Report</h1><p>Body content here.</p>");
pdf.SaveAs("dynamic-header-report.pdf");

using IronPdf;

string userName = GetCurrentUserName();
string documentVersion = "v2.3.1";

var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = $"<div style='font-size:10px;'>Prepared by: {userName} " +
                   $"| Version: {documentVersion} " +
                   "| Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

var pdf = renderer.RenderHtmlAsPdf("<h1>Annual Report</h1><p>Body content here.</p>");
pdf.SaveAs("dynamic-header-report.pdf");

Note that the {page} and {total-pages} tokens are left as plain strings within the C# string concatenation -- not inside the interpolated portion. During PDF rendering, IronPDF replaces those tokens automatically. This pattern works for any runtime value: user names from Active Directory, document IDs from a database, version strings from your build pipeline, or calculated totals from your reporting engine.

The combination of mergeable fields and string interpolation enables sophisticated footer designs common in business documents. Legal departments often require footers showing document title, date, and page count. Financial reports may need timestamps for regulatory compliance. These requirements are met without custom code for each document type.

What Does the iText 7 Approach Look Like?

Developers familiar with iText 7 (the successor to iTextSharp) know that adding headers and footers requires implementing event handlers. The library uses a page event system where you create a class that responds to document lifecycle events like OnEndPage and OnCloseDocument.

Here is how the same header and footer implementation looks with iText 7, using the ITextEvents pattern:

using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using iText.Kernel.Events;
using iText.Kernel.Geom;
using iText.Layout.Properties;

// Event handler class for headers and footers -- similar to PdfPageEventHelper
public class ITextEvents : IEventHandler
{
    private string _header;
    public string Header
    {
        get { return _header; }
        set { _header = value; }
    }

    public void HandleEvent(Event currentEvent)
    {
        PdfDocumentEvent docEvent = (PdfDocumentEvent)currentEvent;
        PdfDocument pdfDoc = docEvent.GetDocument();
        PdfPage page = docEvent.GetPage();
        Rectangle pageSize = page.GetPageSize();

        // Create a new PdfCanvas for the contentbyte object
        PdfCanvas pdfCanvas = new PdfCanvas(
            page.NewContentStreamBefore(),
            page.GetResources(),
            pdfDoc);
        Canvas canvas = new Canvas(pdfCanvas, pageSize);

        // Add header text at calculated position
        canvas.ShowTextAligned(
            new Paragraph("Quarterly Sales Report"),
            pageSize.GetWidth() / 2,
            pageSize.GetTop() - 20,
            TextAlignment.CENTER);

        // Add footer with page number
        int pageNumber = pdfDoc.GetPageNumber(page);
        canvas.ShowTextAligned(
            new Paragraph($"Page {pageNumber}"),
            pageSize.GetWidth() / 2,
            pageSize.GetBottom() + 20,
            TextAlignment.CENTER);

        canvas.Close();
    }
}

// Usage in main code
var writer = new PdfWriter("report.pdf");
var pdfDoc = new PdfDocument(writer);
var document = new Document(pdfDoc);

// Register the event handler for END_PAGE
pdfDoc.AddEventHandler(PdfDocumentEvent.END_PAGE, new ITextEvents());

document.Add(new Paragraph("Sales Data"));
document.Add(new Paragraph("Content goes here..."));
document.Close();

using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using iText.Kernel.Events;
using iText.Kernel.Geom;
using iText.Layout.Properties;

// Event handler class for headers and footers -- similar to PdfPageEventHelper
public class ITextEvents : IEventHandler
{
    private string _header;
    public string Header
    {
        get { return _header; }
        set { _header = value; }
    }

    public void HandleEvent(Event currentEvent)
    {
        PdfDocumentEvent docEvent = (PdfDocumentEvent)currentEvent;
        PdfDocument pdfDoc = docEvent.GetDocument();
        PdfPage page = docEvent.GetPage();
        Rectangle pageSize = page.GetPageSize();

        // Create a new PdfCanvas for the contentbyte object
        PdfCanvas pdfCanvas = new PdfCanvas(
            page.NewContentStreamBefore(),
            page.GetResources(),
            pdfDoc);
        Canvas canvas = new Canvas(pdfCanvas, pageSize);

        // Add header text at calculated position
        canvas.ShowTextAligned(
            new Paragraph("Quarterly Sales Report"),
            pageSize.GetWidth() / 2,
            pageSize.GetTop() - 20,
            TextAlignment.CENTER);

        // Add footer with page number
        int pageNumber = pdfDoc.GetPageNumber(page);
        canvas.ShowTextAligned(
            new Paragraph($"Page {pageNumber}"),
            pageSize.GetWidth() / 2,
            pageSize.GetBottom() + 20,
            TextAlignment.CENTER);

        canvas.Close();
    }
}

// Usage in main code
var writer = new PdfWriter("report.pdf");
var pdfDoc = new PdfDocument(writer);
var document = new Document(pdfDoc);

// Register the event handler for END_PAGE
pdfDoc.AddEventHandler(PdfDocumentEvent.END_PAGE, new ITextEvents());

document.Add(new Paragraph("Sales Data"));
document.Add(new Paragraph("Content goes here..."));
document.Close();

This implementation demonstrates the fundamental architectural difference between the two libraries. iText 7 requires creating a separate handler class that implements IEventHandler (similar to the legacy PdfPageEventHelper), manually calculating page positions using float coordinates, and managing the PdfCanvas and Canvas objects for drawing operations. The handler receives events for each page through the END_PAGE event type -- a detail that trips up many developers who mistakenly use START_PAGE.

How Do the Two Approaches Compare?

The differences become clearer when you look at specific capabilities side-by-side. The following table summarizes the key distinctions:

The development experience also differs significantly when troubleshooting issues. IronPDF's HTML-based approach means you can preview your header design in a browser before integrating it into your PDF generation code. If something looks wrong, you can adjust the HTML and CSS using familiar browser developer tools. With iText 7, debugging positioning issues requires generating test PDFs repeatedly and manually measuring coordinates.

The HTML-based approach means you can apply existing web development skills directly. Any layout achievable with HTML and CSS works in IronPDF headers and footers, from flexbox arrangements to image grids. The HTML Headers and Footers example demonstrates additional styling possibilities.

using IronPdf;
using IronSoftware.Drawing;

var renderer = new ChromePdfRenderer();

var footer = new TextHeaderFooter
{
    LeftText = "Confidential",
    CenterText = "{pdf-title}",
    RightText = "Page {page} of {total-pages}",
    Font = FontTypes.Arial,
    FontSize = 9,
    DrawDividerLine = true,
    DrawDividerLineColor = Color.Gray
};

renderer.RenderingOptions.TextFooter = footer;
renderer.RenderingOptions.MarginBottom = 20;

var pdf = renderer.RenderHtmlAsPdf("<h1>Board Report</h1><p>Executive summary content.</p>");
pdf.SaveAs("board-report.pdf");

using IronPdf;
using IronSoftware.Drawing;

var renderer = new ChromePdfRenderer();

var footer = new TextHeaderFooter
{
    LeftText = "Confidential",
    CenterText = "{pdf-title}",
    RightText = "Page {page} of {total-pages}",
    Font = FontTypes.Arial,
    FontSize = 9,
    DrawDividerLine = true,
    DrawDividerLineColor = Color.Gray
};

renderer.RenderingOptions.TextFooter = footer;
renderer.RenderingOptions.MarginBottom = 20;

var pdf = renderer.RenderHtmlAsPdf("<h1>Board Report</h1><p>Executive summary content.</p>");
pdf.SaveAs("board-report.pdf");

What Are Your Next Steps?

Implementing headers and footers in your PDF documents takes just a few minutes with IronPDF. Install the library via NuGet Package Manager:

Install-Package IronPdf
dotnet add package IronPdf

Install-Package IronPdf
dotnet add package IronPdf

From here, these resources will help you go further:

• Getting Started documentation -- covers the full range of PDF generation and manipulation capabilities
• Headers and Footers How-To Guide -- step-by-step instructions for all header and footer scenarios
• HTML Headers and Footers example -- ready-to-run code samples for HTML-based headers
• Advanced Headers and Footers example -- per-page targeting and odd/even page differentiation
• TextHeaderFooter API reference -- complete property list for text-based headers and footers
• HtmlHeaderFooter API reference -- full API for HTML-based headers and footers
• Docker deployment guide -- configuration for Linux containers and cloud environments
• IronPDF licensing options -- plans for individual developers through to enterprise teams

Start your free trial to test header and footer implementations in your own projects. The trial includes all features with no time limit on functionality, allowing you to evaluate the library against your real-world PDF document requirements before committing to a license.

Adding headers and footers to PDF documents in C# ranges from straightforward to involved, depending on your library choice. While iText 7 provides low-level control through event handlers and canvas operations, IronPDF delivers the same functionality through an API that applies familiar HTML and CSS concepts. For developers prioritizing rapid implementation and maintainable code, IronPDF reduces header and footer implementation from dozens of lines -- including handler classes, cell configurations, and table structures -- to just a few property assignments.