Add an Image to a PDF
Add Image places a PNG, JPEG or SVG picture on a PDF at the x and y position you give, in points from the lower-left corner. It stamps the first page only unless you choose every page.
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 Image overlays `imageFile` at `(x,y)` in PDF points (origin lower-left). Raster files become a Flate XObject. SVG is printed through WeasyPrint then imported as a Form. `everyPage=true` stamps all pages; otherwise only the first page.
The download is named `overlayed_{base}.pdf`. Password-protected files are unlocked for you on this page once you enter the password; API callers run Unlock first.
There is no scale field; size is the image's native width/height in the `cm` matrix. Opacity is not a parameter.
For a text mark use Add Stamp. For another PDF as the layer, Overlay PDFs.
The image is drawn on top of the existing page content, in the last position of the page's drawing order. It does not replace or hide anything underneath at a structural level: the text and graphics below are still in the file, just covered where the image is opaque. That makes it fine for a logo in a clear corner and unsuitable for covering confidential content, which needs a real redaction tool.
Placement is a single anchor. `x` and `y` give the image's lower-left corner in points from the lower-left corner of the page, and the image extends right and up from there. The size is not chosen by you: a raster is placed at one PDF point per pixel, so a 300 by 100 pixel PNG occupies 300 by 100 points, about 4.2 by 1.4 inches. A letter page is 612 by 792 points, so anything much wider than that will run off the page. Resize the picture to the size you want before uploading it.
Raster images (PNG and JPEG) are decoded and re-stored as 8-bit RGB. Transparency is not kept, so a PNG with a transparent background may show a solid block in place of the see-through area. If you need a logo that blends with the page, export it with a white or matching background first, or place it only on a white area.
`everyPage=false` puts the image on page 1 only; `everyPage=true` repeats it at the same coordinates on every page. Pages of different sizes get the same anchor, so on a mixed file the mark can land in different visual spots. There is no way to pick pages 2 and 5 only; split the file, stamp the part you want, and merge back if you need that.
If the upload fails, the usual cause is a file that is not an image the decoder understands, which returns an unsupported-file-type message, or a missing `imageFile`. Re-export the picture as PNG or JPEG and try again.
Features
- Raster XObject or SVG-via-WeasyPrint Form
- `x`,`y` in points; first page or every page
- No opacity or scale control
- Anonymous API at /api/v1/misc/add-image
When to use this tool
- Place a PNG logo on page 1
- Repeat a mark on every page at a fixed point
- Drop an SVG through WeasyPrint when you accept print fidelity
- Add a scanned signature image to the signature line of a one-page agreement
- Put a company seal in the footer of every page of a report that uses uniform page sizes
How do I add an image to a PDF?
- Upload a PDF and an image (PNG, JPEG, or SVG).
- Set x and y from the lower-left, in points.
- Choose first page only or every page.
- Download overlayed_*.pdf and check the anchor.
Limits and edge cases
- No scale/opacity fields
- One anchor point only: no per-page selection beyond first page or every page
- Does not remove or hide content underneath the image
- Giant rasters become giant PDF placements
- Transparent PNG areas are not preserved: images are converted to RGB, so transparent pixels take the colour stored under them, often black
- Password-protected files need the password; API callers run Unlock first
- 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
- x=0 y=0 puts the image's lower-left at the page's lower-left
- everyPage false leaves pages 2+ unchanged
- A 200 by 80 pixel PNG logo with x=400, y=20 and everyPage=true sits in the bottom-right corner of every letter-size page, 200 points wide, and the download is named overlayed_report.pdf for an input called report.pdf
- A 1800 pixel wide photo placed at x=0, y=0 covers well beyond a 612-point-wide page, which shows the placement size follows pixels; shrink the picture to about 150 pixels wide first
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
- Why is the logo huge?
- The cm matrix uses the image's pixel width and height as PDF units. A 2000px PNG is 2000 points wide.
- Is y from the top?
- No. PDF space is lower-left origin on typical pages.
- Can I set opacity?
- No. The overlay is opaque drawing operators.
- Does SVG keep vectors?
- SVG is WeasyPrint-printed to a one-page PDF, then placed as a form. Expect a print, not editable SVG.
- How do I make the image smaller?
- Resize it before uploading. There is no scale field, and the placed size follows the image's pixel dimensions, so a 150 by 50 pixel logo takes 150 by 50 points.
- Why does my transparent PNG show a black or solid box?
- Images are converted to RGB and the alpha channel is dropped. Re-export the logo on a white background, or place it on a part of the page that is white.
- Can I put the image on page 3 only?
- Not directly. The choice is page 1 or every page. Split out the page you want, add the image there, then merge the files back in order.
- Can I use this to hide text on the page?
- Not safely. The text stays in the file under the image and can still be selected or extracted. Use Auto Redact when the content must be removed.
- The image is off the page. How do I find the right coordinates?
- Measure from the lower-left corner in points. On a letter page that is 612 by 792, so x=450 and y=40 puts the lower-left of a logo near the bottom right, as long as the logo fits within the remaining 162 points of width.
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-image" \
-F "[email protected]" \
-F "[email protected]" \
-F "x=0" \
-F "y=0" \
-F "everyPage=false" \
-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 image for you with this skill: /skills/pdf123-add-image.md
Files are used only for this processing job and deleted automatically afterward.