Add Page Numbers

Adding page numbers to a PDF involves appending text-drawing operators to each page's content stream. In the PDF imaging model, text is painted by a sequence of operators: BT (begin text), Tf (set font and size), Td (position text cursor), Tj or TJ (show text string), and ET (end text). To add a page number, the tool constructs these operators with the appropriate font reference, glyph string, and positioning coordinates, then appends them to the existing content stream as an overlay.

Positioning the page number requires understanding the page's coordinate system. PDF pages use a coordinate system measured in points (1 point = 1/72 inch) with the origin typically at the bottom-left corner of the media box. A page number placed at "bottom-center" is positioned at (mediaBoxWidth / 2, marginOffset) with the text centered using the Tc (character spacing) or by pre-calculating the string width. The tool reads each page's media box dimensions to compute the correct absolute coordinates, accounting for pages of different sizes within the same document.

Font embedding is a critical consideration when adding text to an existing PDF. The page number text requires a font resource that may not exist in the original document. The tool embeds a standard font (such as Helvetica or Times-Roman from the PDF base 14 fonts, which all PDF readers are required to support) or embeds a subset of a custom font. Using the base 14 fonts avoids increasing file size, since these fonts are built into every conforming PDF renderer. For documents requiring specific typography, the tool embeds the minimum subset of glyphs needed (the digits 0-9, any prefix/suffix characters, and optionally Roman numeral letters) to keep the size overhead negligible.

The content stream architecture in PDF separates content into a stack of graphical states. When appending page number operators, the tool wraps them in a q...Q (save/restore graphics state) pair to ensure the added text does not alter the rendering state of existing content. Without this isolation, the font selection, color, or transformation matrix set by the page number operators could affect subsequent drawing if the original content stream expects a different default state. The save/restore pattern is a standard defensive technique used by all professional PDF modification tools.

Page rotation interacts with page number placement in a way that requires careful handling. A page with /Rotate 90 (landscape) has its content stream defined in portrait coordinates, with the viewer applying a rotation transformation at render time. If the page number is added in the unrotated coordinate system, it will appear sideways when the rotation is applied. The tool detects the /Rotate value for each page and adjusts the text positioning and transformation matrix accordingly, ensuring the page number appears correctly oriented regardless of the page's rotation setting. This per-page rotation detection is essential for documents that mix portrait and landscape pages.

Page numbers are a fundamental element of document usability and professionalism:

• Professional document appearance — Reports, proposals, and white papers without page numbers appear unfinished. Adding consistent pagination signals attention to detail and makes the document look polished and complete.
• Meeting reference — During meetings and presentations, page numbers enable efficient communication: "Turn to page 14" is far more effective than "scroll to the section about quarterly targets." Numbered pages reduce friction in group discussions.
• Legal and regulatory compliance — Court filings, notarized documents, and regulatory submissions often require sequential page numbering. Some jurisdictions mandate specific numbering formats and positions for official documents.
• Print and binding preparation — When printing and binding a document, page numbers are essential for collating pages correctly after printing, especially with duplex output where front and back pages must align. Print shops expect numbered pages for quality verification.
• Table of contents accuracy — A table of contents is only useful when it references page numbers. Adding page numbers to a PDF that was generated without them makes any existing table of contents functional for navigation.
• Academic standards — Thesis guidelines, conference proceedings, and journal submissions universally require page numbering. Many academic institutions specify exact formatting — "centered at the bottom, 12pt Times New Roman, starting from the introduction page."

Many PDF creation workflows — particularly scanned documents, image-based PDFs, and basic export tools — produce files without page numbers. Adding them after the fact with this tool is significantly faster than going back to the source application, adding numbers, and re-exporting. Since the tool processes files locally, it is suitable for any document regardless of confidentiality level.