About PDF Page Numbers
This PDF page numbering tool uses pdf-lib to add page number markers to every page locally in your browser, so documents never leave your device. It supports 6 positions (bottom-center, bottom-left, bottom-right, top-center, top-left, top-right), three number formats (Arabic, Roman, letters) and custom prefixes like "Page X of Y", plus a configurable starting page so cover and table-of-contents pages can stay unnumbered. Page numbers are overlaid as text objects on the content stream without modifying original content, keeping the text layer intact and searchable. A few practical recommendations: for academic papers, skip the cover and begin numbering from the body; for contracts, use "Page X of Y" so parties can reference clauses precisely. And when merging several documents into one book, standardize the numbering scheme first to avoid a mismatched final page sequence. All processing runs client-side via WebAssembly, making it a safe, controllable way to organize contracts, theses and meeting packets. Page numbers and physical order are not the same thing, the most common pitfall. Covers, contents pages and inserts usually sit outside body numbering, so the body page labelled one may be the fifth sheet in the file. Numbering from the first physical page shifts the whole body, and the offset changes the moment an insert is added or removed. Set the start page and start number first. Existing numbers need a separate decision or two schemes stack. A scan may carry printed numbers that cannot be removed, so adding another layer shows two figures at once, and some documents place numbers near the trim edge outside the usual header, easily covered by new ones. Sample a few pages to see where the existing numbers sit before deciding a side. Consistency of format and font affects usability more than looks. A new number in a different face or size looks out of place on the page, and more practically some readers split content by font when extracting text, separating the number from the body. Reuse a subset of a font already in the document and keep size and position aligned. The numbering range must suit the document structure. Numbering the whole document is simplest, yet a book assembled from independent chapters reads better with per-chapter numbering at the cost of qualifying every reference by chapter. Confirm how the document is used — as one unit or as separately circulating chapters — which decides the scheme. Parameterising position makes later changes cheap. When position, margin and format are set as parameters at insertion, an adjustment is a rerun, whereas manual per-page placement means redoing everything for any change. Even for a single document, record the parameters, especially when several documents must share one style. Finally, adding numbers changes content, so be careful with signed or checksummed documents. Any content change invalidates an existing signature even if only a number was added, and a content-digest comparison will also mismatch afterwards. Confirm whether modification is permitted, and where it is not, produce a copy for presentation instead.
How It Works Internally
Adding page numbers draws text onto the page, so three decisions are needed: the starting number, whether the cover counts, the position and format, and whether existing footer content is avoided. Note that the numbering is drawn artwork rather than document structure, so it is independent of whatever page number a viewer displays and the two can disagree.
No number on the cover, body starting at 1Skip drawing on page one and start at 1 from page two — numbering by physical page would start the body at 2Measured on This Page
| Page count | 3 pages in, 3 pages out — numbering adds no pages |
|---|---|
| Numbers written | pypdf extracts "1", "2", "3" in order — the numbers are in the content stream, not an overlay or preview |
| Client-side | Done in-browser via pdf-lib/pdf.js with no upload endpoint |
| Configurable | Position (bottom-left/centre/right, top), font size, format (1 / 1/n / page-1-of-n) and start page |
Stamping page numbers has three real traps: documents that already carry numbers get double-stamped — scans or previously numbered PDFs end up with two sets, and this page does not detect that (check first); the numbers must go into the content stream rather than an annotation layer to survive printing and text extraction, which the successful extraction confirms; and the start-page option exists for covers and tables of contents, so page two displays 1. Encrypted or signed PDFs cannot be rewritten this way — the signature would break — so use an unsigned original.
How to Use
- Open "PDF Page Numbers"
- Click "Choose file" to load a PDF
- Set the position, number format, font size and start page
- Click "Add Page Numbers"; the file downloads automatically
- To redo, simply load the file again
Use Cases
- Academic paper numbering — Add standard page numbers to thesis or journal submissions, skipping the cover page and starting from the body.
- Contract numbering — Add page numbers to multi-page contracts for easy reference and verification using Page X of Y format.
- Report layout — Add bottom-center page numbers to quarterly and annual reports for a professional appearance.
- Book typesetting — Use Roman numerals for preface and Arabic numerals for body content, following publishing conventions.
- Meeting materials — Add page numbers to conference handbooks or training materials for easy page-by-page reference.
FAQ
Can it skip the cover page?
Yes. You can set a starting page so the first few pages have no numbers, starting from a specified page, ideal for cover and table of contents.
What page number formats are supported?
Arabic (1 2 3), Roman (i ii iii), letters (a b c), and custom prefix formats (e.g. Page 1 of 10).
Can the position be customized?
Yes. Six positions are supported: bottom-center, bottom-left, bottom-right, top-center, top-left and top-right.
Does it modify the original PDF content?
No. Page numbers are overlaid as text objects on the content stream without modifying or overwriting original page content; the text layer stays searchable.
Can one document use multiple numbering formats?
By default the whole document is numbered uniformly. For mixed schemes like Roman preface plus Arabic body, split the document and process each part separately.
Are files uploaded?
No. All page numbering runs locally in your browser via pdf-lib, so files never leave your device, even sensitive documents.
How do I start numbering from page two?
Combine the start-page and start-number options: set the position to page two and the number to one, so the cover carries no number and the body starts at 1. To reserve the cover without showing a number, mark it as skipped.
The new page numbers overlap the existing ones?
Identify where the original numbers sit and place the new ones in the opposite corner or adjust the margin. If the old numbers are part of the content, overlap is unavoidable — either replace them (strip the old first) or use a blank area.