Add Classic Text Headers & Footers

import {PdfDocument, AffixFonts} from "@ironsoftware/ironpdf";

(async () => {
    // Configure render options
    const options = {
        firstPageNumber: 1, // Use 2 if a cover page will be appended

        // Add a header to every page
        textHeader: {
            dividerLine: true,
            centerText: "{html-title}",
            font: AffixFonts.Helvetica, // Use the font name or font file path
            fontSize: 12,
        },

        // Add a footer
        textFooter: {
            dividerLine: true,
            leftText: "{date} {time}",
            rightText: "{page} of {total-pages}",
            font: AffixFonts.Arial, // Use the font name or font file path
            fontSize: 10,
        },
        // Mergeable fields are: {page} {total-pages} {url} {date} {time} {html-title} & {pdf-title}

        margin: {
            top: 25, // Create 25mm space for the header
            bottom: 25, // Create 25mm space for the footer
        },
    };

    // Define HTML content
    const htmlContent = "<h1>Hello IronPDF</h1>";

    // Render HTML content to a PDF with headers and footers
    const pdf = await PdfDocument.fromHtml(htmlContent, {renderOptions: options });

    // Save the PDF with headers and footers
    await pdf.saveAs("header_footer.pdf");
})();

Add Classic Text Headers & Footers

Learn how to add text headers and footers to a PDF document when rendering HTML content.

To include text headers and footers, you need to specify them in the rendering options object. Define the header content with a divider line, centered text displaying the HTML title, font settings, and font size. Similarly, define the footer with the textFooter property. You can utilize fields like {page}, {total-pages}, {url}, {date}, {time}, {html-title}, and {pdf-title} to personalize the content.

Customize margins to accommodate the header and footer appropriately.

Utilize the PdfDocument.fromHtml method to convert your HTML content into a PDF. Pass the renderOptions object as an option.

For detailed documentation on creating PDFs from HTML, visit the IronPDF Documentation.

The resulting PDF document, complete with headers and footers, is saved under the name "header_footer.pdf."

// Import the necessary namespace
using IronPdf;

class Program
{
    static void Main()
    {
        // Define your HTML content
        string htmlContent = @"<html><body><h1>Hello, World!</h1><p>This is a PDF document with headers and footers.</p></body></html>";

        // Create the rendering options for the PDF
        var renderOptions = new PdfPrintOptions()
        {
            // Specify header settings with fields
            Header = new SimpleHeaderFooter()
            {
                CenterText = "{pdf-title}",
                FontFamily = "Arial",
                FontSize = 14,
                DrawDividerLine = true,
                Height = 50 // Customize height based on needs
            },
            // Specify footer settings with fields
            Footer = new SimpleHeaderFooter()
            {
                CenterText = "Page {page} of {total-pages}",
                FontFamily = "Arial",
                FontSize = 12,
                DrawDividerLine = true,
                Height = 50 // Customize height based on needs
            },
            MarginTop = 50, // Adjust top margin for header
            MarginBottom = 50 // Adjust bottom margin for footer
        };

        // Create a PDF document from HTML with the specified options
        var pdfDocument = PdfDocument.FromHtml(htmlContent, renderOptions);

        // Save the PDF document with headers and footers
        pdfDocument.SaveAs("header_footer.pdf");
    }
}

// Import the necessary namespace
using IronPdf;

class Program
{
    static void Main()
    {
        // Define your HTML content
        string htmlContent = @"<html><body><h1>Hello, World!</h1><p>This is a PDF document with headers and footers.</p></body></html>";

        // Create the rendering options for the PDF
        var renderOptions = new PdfPrintOptions()
        {
            // Specify header settings with fields
            Header = new SimpleHeaderFooter()
            {
                CenterText = "{pdf-title}",
                FontFamily = "Arial",
                FontSize = 14,
                DrawDividerLine = true,
                Height = 50 // Customize height based on needs
            },
            // Specify footer settings with fields
            Footer = new SimpleHeaderFooter()
            {
                CenterText = "Page {page} of {total-pages}",
                FontFamily = "Arial",
                FontSize = 12,
                DrawDividerLine = true,
                Height = 50 // Customize height based on needs
            },
            MarginTop = 50, // Adjust top margin for header
            MarginBottom = 50 // Adjust bottom margin for footer
        };

        // Create a PDF document from HTML with the specified options
        var pdfDocument = PdfDocument.FromHtml(htmlContent, renderOptions);

        // Save the PDF document with headers and footers
        pdfDocument.SaveAs("header_footer.pdf");
    }
}

' Import the necessary namespace
Imports IronPdf

Friend Class Program
	Shared Sub Main()
		' Define your HTML content
		Dim htmlContent As String = "<html><body><h1>Hello, World!</h1><p>This is a PDF document with headers and footers.</p></body></html>"

		' Create the rendering options for the PDF
		Dim renderOptions = New PdfPrintOptions() With {
			.Header = New SimpleHeaderFooter() With {
				.CenterText = "{pdf-title}",
				.FontFamily = "Arial",
				.FontSize = 14,
				.DrawDividerLine = True,
				.Height = 50
			},
			.Footer = New SimpleHeaderFooter() With {
				.CenterText = "Page {page} of {total-pages}",
				.FontFamily = "Arial",
				.FontSize = 12,
				.DrawDividerLine = True,
				.Height = 50
			},
			.MarginTop = 50,
			.MarginBottom = 50
		}

		' Create a PDF document from HTML with the specified options
		Dim pdfDocument = PdfDocument.FromHtml(htmlContent, renderOptions)

		' Save the PDF document with headers and footers
		pdfDocument.SaveAs("header_footer.pdf")
	End Sub
End Class

$vbLabelText $csharpLabel

Explore Headers & Footers Example Code on GitHub