Add Page Numbers to a PDF
Add Page Numbers prints a page number onto every page of a PDF as real text. You choose one of six positions along the top or bottom edge, the font size and the starting number; the digits are set in Helvetica.
Drag and drop files here, or click to choose
Accepts PDF · up to 500.0 MB per file · up to 20 files at once
You can also paste a file with Ctrl/Cmd+V, or from the clipboard menu.
Add Page Numbers draws a decimal page index onto every page as real PDF text. Reviewers who write "see page 12", print packets, and filing systems that need a visible number: those are the jobs.
The digits are Helvetica, in black, at the size and corner you set. There is no font choice. Starting number and position are honored: 1/2/3 are top left, center, right; 7/8/9 are the matching bottom corners. The portal default position is 8 (bottom center). The default start is 1.
Numbers become page content. They travel with the file. They are not a viewer-only overlay, and they do not rewrite the PDF page-label dictionary that some readers show in a thumbnail pane.
If pages already have printed numbers, a second set will collide. Split the cover off first if it should stay unnumbered. Merge first, then number, if the whole binder should share one sequence. Number first, then merge, if each part should keep its own start.
Starting at 101 is how volume II continues after a 100-page volume I. Values below a readable print size are a bad idea even when the API accepts them; 12 is the form default.
This does not change logical labels in every viewer. For title/author metadata, use Update Metadata. Password-protected files are unlocked for you on this page once you enter the password; API callers run Unlock first.
Position is a numeric corner code rather than a free x/y coordinate. 1, 2, 3 place the number along the top edge left, center, and right; 7, 8, 9 place it along the bottom edge left, center, and right. There is no way to nudge the number by a few points or to set a custom offset from the margin, so a page with unusual margins or a full-bleed photo can end up with the digit sitting where you do not want it. In that case, number a copy, then crop or use Add Stamp with a custom placement for finer control.
The stamp is added, never detected. The tool has no idea whether a page already carries a printed number. If you run it twice you get two overlapping digits. If the source already has numbers in the footer and you add a bottom-center stamp, they will collide. Strip existing numbering first, or choose a corner the original leaves empty.
Because the digits are drawn as page content, they are also rasterized by any later rendering step. If you number first and then run PDF to Images or OCR, the numbers are part of the pixels and will be read back as text. Number last, after any OCR, when the sequence should not appear in the extracted text.
Font size interacts with page size. A size that reads well on A4 can be cramped on a large-format drawing and oversized on a small label PDF. Preview the first and last page at 100% before stamping a whole run, and remember that a print at reduced scale shrinks the number along with the rest of the page.
Only stamp documents you are allowed to alter. Keep an unstamped original when the filing process cares about an unmarked source.
Features
- Draws Helvetica digits into page content (not a viewer overlay)
- Honors starting number, font size, and corner position
- Always Helvetica; there is no font choice
- Corner codes only; no custom x/y placement
- Anonymous API at /api/v1/misc/add-page-numbers
When to use this tool
- Number a merged exhibit binder
- Continue a sequence across volumes with a non-1 starting number
- Give a print packet numbers reviewers can cite
- Add a page reference to a scan set before it goes to a court or insurer
How do I add page numbers to a PDF?
- Upload the PDF that needs visible page numbers.
- Set font size, starting number, and position.
- Click Process and download the stamped PDF.
- Check first, middle, and last pages so the digits do not sit on punch holes or photos.
Limits and edge cases
- May overlap existing printed numbers
- Always Helvetica; no font choice
- Does not rewrite PDF page-label dictionaries
- Fixed corner codes; no custom x/y offset
- Numbers every page, including covers
- Upload limit on this website: 500 MB per file, sent in chunks above about 95 MB. A single direct API request body is capped at 100 MB.
Examples
- Starting at 1 on a 40-page brief labels pages 1 through 40
- Starting at 21 continues numbering after a 20-page volume I
- Position 3 and position 9 put the same number top-right and bottom-right respectively
Privacy for this tool
Files are uploaded over HTTPS, processed in memory or a short-lived temporary directory on our servers, and deleted when your result is ready. We do not keep copies for later browsing, training, or advertising profiles. See the Privacy Policy for retention details and AdSense cookie disclosures.
Frequently asked questions
- Can I skip numbering the cover?
- This tool numbers every page in the file you upload. Split the cover off first if it should stay unnumbered.
- Can I change the font?
- No. The numbers are always drawn in black Helvetica.
- Do numbers become part of the PDF?
- Yes. They are drawn into page content. They do not update every viewer's page-label dictionary.
- Can I use Roman numerals?
- No. The stamp is a decimal integer from startingNumber plus the page index.
- Can I place the number at a custom position?
- No. You choose one of the fixed corner codes. For a custom spot, use Add Stamp, which accepts an explicit position.
- What happens if I run it twice?
- You get two sets of overlapping digits, because the tool never detects existing numbers. Number a fresh copy instead.
- Will the numbers show up in OCR later?
- Yes. They are real page text, so a later OCR or text extraction reads them. Number after OCR if the sequence should not be extracted.
Last updated:
Call this from code
Every tool on this site is a plain REST endpoint - no account or API key needed for anonymous use. Built for AI agents and developers as much as for browsers.
curl -X POST "https://pdf123.xyz/api/v1/misc/add-page-numbers" \
-F "[email protected]" \
-F "fontSize=12" \
-F "position=8" \
-F "startingNumber=1" \
-o output.pdfAlso available as an MCP tool for agent clients that speak Model Context Protocol (JSON-RPC 2.0 over POST /mcp). Full API reference
Use it from an AI agent
SkillClaude Code, Codex, Cursor and other AI agents can run Add Page Numbers for you with this skill: /skills/pdf123-add-page-numbers.md
Files are used only for this processing job and deleted automatically afterward.