PDF Overlay combines two PDFs by drawing the pages of one document on top of the pages of another, with the base PDF keeping full control over the final page count, page order, and page boxes. The browser-side tool accepts a base file and an overlay file, each no larger than 25 MiB, embeds the overlay artwork, centers it proportionally on every base page at the opacity you choose between 0.1 and 1, then downloads a single combined file named with -overlay inserted before the .pdf extension. Because nearly every mistake flows from misunderstanding which file is the base, how pages map to each other, what opacity actually does, and why a visual overlay is not a security control, most errors can be prevented by working through those four points before clicking. This guide walks through the common mistakes, the safer alternative for each one, and the exact workflow that produces a clean, predictable result.
What PDF Overlay Actually Does
Before listing mistakes, it helps to fix a clear mental model of the tool. PDF Overlay is a browser-based operation that takes a base PDF, takes an overlay PDF, fits each overlay page inside the corresponding base page while preserving aspect ratio, centers the result, and draws it on top at the opacity you select. The combined file is serialized locally and downloaded as a new file; neither input is uploaded and neither original is overwritten. The base document stays in charge of the final document: its page count, page order, and page boxes determine what the output looks like, and the overlay is drawn afterward as artwork above the existing base content.
The tool is built around an embed-and-draw workflow in the browser, which is why the overlay layer remains vector-based wherever the underlying content is vector, and why interactive objects such as links, form fields, comments, scripts, attachments, and outline destinations are not carried over as equivalents by the drawing operation. Treat the result as a visual combination, not as a structural merge of every document feature. For a closer look at the drawing model used behind the scenes, the pdf-lib drawPage reference describes how a page can be drawn on top of another with size, position, and opacity controls.
Mistake 1: Choosing the Wrong Base PDF
The most expensive mistake is treating the two files as interchangeable. The base PDF is the document that survives into the output; the overlay PDF is just artwork drawn on top. If you swap them, the output will have the wrong number of pages, the wrong page sizes, and the wrong underlying content, even if the overlay opacity is correct and the mapping rule is followed to the letter. Pick the base so that its page count, page order, and page boxes are exactly what you want in the final file.
A practical check before starting: open both files and ask which one should be readable on its own without the other layer. That file is almost always the base. Common examples include using a generated report PDF as the base with a prepared letterhead layer as the overlay, or using a generated invoice PDF as the base with a "PAID" stamp layer as the overlay. Reverse the choice and the result becomes nonsensical, because the stamp or letterhead becomes the body of the document and the report pages disappear into the background.
Mistake 2: Misunderstanding the Page-Mapping Rule
The overlay tool follows two explicit mapping rules, and mixing them up is the second most common source of errors. When the overlay PDF has exactly one page, that single page is repeated on every base page, which is the right setup for letterhead, borders, stamp sheets, and other reusable foreground layers. When the overlay PDF has more than one page, overlay page 1 maps to base page 1, overlay page 2 maps to base page 2, and so on. Base pages beyond the overlay count remain unchanged, and overlay pages beyond the base count are ignored.
| Overlay file shape | Mapping behavior | Typical use case |
|---|---|---|
| Exactly 1 page | That page repeats on every base page | Letterhead, full-page border, watermark sheet, "DRAFT" stamp |
| 2+ pages, fewer than base | Page-by-page; later base pages unchanged | Per-page artwork such as chapter title cards or section headers |
| 2+ pages, more than base | Page-by-page; extra overlay pages ignored | Drawing from a longer master sheet against a shorter report |
| 2+ pages, equal to base | Page-by-page pairing across the entire document | One-to-one cover-to-content designs and matching foreground sheets |
If you wanted a single repeating stamp and supplied a multi-page overlay instead, the first base page will receive only the first overlay page, and the remaining base pages will be left untouched. If you wanted page-by-page artwork and supplied a single-page overlay, every base page will receive that same artwork instead of the per-page design you planned. For a deeper look at how this works in practice, see how overlay pages are matched to base pages.
Mistake 3: Assuming Opacity Is the Same as Redaction
Opacity controls how the overlay layer is drawn, and that is all it does. A value of 1 draws the layer fully on top; values between 0.1 and 0.9 make the overlay more transparent where the underlying PDF graphics model supports it. A dark or fully opaque overlay can hide base content visually, but the underlying text, vectors, and images stay inside the base content stream and can still be extracted, copied, selected, or revealed by anyone who opens the file in a viewer and removes or repaints the overlay layer. Hiding content visually is not secure redaction.
This matters in two directions. First, do not rely on an opaque overlay to hide confidential numbers, names, or account details before sharing a file, because the data remains recoverable. Second, do not assume that placing a signature-looking image with overlay opacity creates a cryptographic digital signature — it does not, and it establishes no signer identity. The tool also does not inspect blend modes, knockouts, overprint settings, spot colors, or printing separations, so any file destined for professional print still requires a separate preflight step. For visual combinations such as letterhead, borders, stamp sheets, and report overlays, the tool is exactly right; for privacy or signing workflows, you need a different solution.
For a focused treatment of the security illusion and how the file actually behaves underneath, see does an opaque overlay securely remove base PDF content.
Mistake 4: Ignoring the 25 MiB and File-Type Limits
Both the base and the overlay must be non-empty PDFs no larger than 25 MiB each. Encrypted, damaged, unsupported, oversized, or incorrectly labeled files produce a visible error, and the tool does not attempt to recover or guess the format. Password protection is not bypassed, so a locked PDF cannot be opened just because you can load it into the page. If either input is over the 25 MiB limit, the most reliable fix is to compress eligible JPG-heavy PDFs locally first, or to split the file into parts and overlay each part separately.
Two more practical limits are easy to miss. The tool does not offer arbitrary offsets, rotation controls, alignment corners, fill-and-crop behavior, or separate scaling for width and height. Each overlay page is scaled uniformly, fitted inside the base page without cropping or stretching, and centered horizontally and vertically. When the two page shapes differ — for example, an A4 base with a US Letter overlay — blank space can remain on two sides because the aspect ratio is preserved. If you need a tight crop to specific corners, the overlay tool alone cannot do it; you would need a separate crop step afterward.
Mistake 5: Skipping the Inspection Step
A combined PDF can look correct in the small preview inside the browser and still be wrong in ways that only show up later: a stamp landing on top of body text, a border clipping against an unusual page box, an opacity choice that washes out the underlying data, or a page where the mapping rule produced an unexpected result. The fix is mechanical: open the downloaded file, scroll every page that matters, and confirm the layer sits where you expect, at the opacity you chose, without covering information you still need to read.
Two extra checks are worth building into the habit. First, remember that a stale job cannot replace results made from newer file choices or opacity settings; changing either input or opacity revokes the previous object URL and removes the obsolete download, which is a safety feature rather than an annoyance, because it stops you from saving the wrong file by accident. Second, to inspect efficiently, focus on the first page, a middle page, and the last page of any non-trivial document. For a single-page repeating overlay, three to five scattered sample pages are usually enough to catch a problem without opening every single page.
How to Overlay PDF Pages Step by Step
- Open PDF Overlay in your browser. The tool runs locally; neither input is uploaded.
- Choose the base PDF. This is the document whose page count, page order, and page boxes you want preserved in the output.
- Choose the overlay PDF. Confirm it is under 25 MiB, not encrypted, and a valid PDF.
- Decide whether the overlay is single-page or multi-page, and verify the mapping rule fits your intent: a single page repeats on every base page; multiple pages map one to one.
- Set the overlay opacity between 0.1 and 1. Use a lower value when the base content must stay readable; use 1 only when the overlay is meant to fully cover the base artwork.
- Select Overlay PDFs and wait for the browser to assemble the file. The previous object URL is revoked automatically.
- Download the combined PDF. The filename is your base filename with -overlay inserted before the .pdf extension.
- Open the downloaded file and inspect every important page: first, middle, and last for multi-page overlays, and a few scattered pages for single-page overlays.
- If anything is wrong, change the input files or opacity and run the overlay again. The new result replaces the previous download; the originals are never overwritten.
When to Use a Different Tool Instead
PDF Overlay is the right choice when you want to layer artwork on top of an existing PDF without changing page count, page order, or page boxes — for example, dropping letterhead above generated pages, adding a prepared border, combining a transparent design layer with a report, or pairing corresponding foreground sheets with a base document. It is not the right tool when you need to concatenate files, interleave two documents, stamp generated text marks, or draw a handwritten signature.
| If you need to… | Use this tool instead |
|---|---|
| Combine several PDFs into one file in your chosen order | Merge PDF |
| Interleave two PDFs in A1, B1, A2, B2 order | Alternate Mix PDF |
| Stamp clear, adjustable text watermarks onto PDF pages | Add Watermark to PDF |
| Add a handwritten signature to a PDF | Sign PDF |
| Remove unwanted pages after the overlay is applied | Delete PDF Pages |
Picking the right tool up front is itself one of the best ways to avoid mistakes, because it removes the temptation to use an overlay layer as a workaround for jobs the tool was never designed to perform.