Attach Files Inside a PDF
Add Attachments embeds one or more files inside a PDF as attachments that viewers list in their attachments panel. It only adds files, and does not convert the PDF to PDF/A-3.
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 Attachments embeds each `attachments` file into `/EmbeddedFiles` as an EmbeddedFile stream plus Filespec. Sending no attachments is rejected with an error. `convertToPdfA3b` is ignored; nothing is converted to PDF/A-3b.
This is not concatenating PDFs (Merge) and not overlaying pages. Recipients need a viewer that shows attachments.
Password-protected files are unlocked for you on this page once you enter the password; API callers run Unlock first. Filenames are stored on the Filespec `/F` and `/UF`.
There is no download of a PDF/A-3b invoice package from this checkbox.
Each attachment is written as raw bytes. Nothing is scanned, converted, thumbnailed or renamed, and the embedded stream is typed `application/octet-stream` with a `Size` parameter, so the original file comes back out byte for byte when a viewer extracts it. The visible pages of the PDF are not changed; only the catalog gains the embedded-file entries.
You can select several files in one run and each becomes its own entry. The output is a normal PDF named after your input, so a viewer that has no attachments pane will simply show the original pages and hide the embedded files. Tell recipients to look for the paperclip or attachments panel in Acrobat, Foxit or a similar desktop reader.
Use this when the extra file must travel inside the PDF. If you want the second document's pages in the reading flow, use Merge. If you want one page drawn on top of another, use Overlay PDFs.
Features
- Several files can be embedded in one run, each with its own Filespec
- Original bytes are kept; visible pages are unchanged
- Embed files in the PDF EmbeddedFiles name tree
- `convertToPdfA3b` unused
- At least one attachment is required
- Anonymous API at /api/v1/misc/add-attachments
When to use this tool
- Clip a spreadsheet to a PDF cover letter
- Carry source files inside a PDF for a reviewer who uses Acrobat
- Skip the PDF/A-3 checkbox
- Ship a report together with the CSV of the data behind its charts so a reviewer can re-run the numbers
- Include a signed scan and its editable Word source in a single file to forward
How do I attach a file to a PDF?
- Upload a PDF and one or more files to embed.
- Leave convertToPdfA3b off; it does not convert.
- Click Process and download the PDF.
- Open the attachments panel in a desktop viewer.
- Check that every file you added is listed under the exact file name you uploaded.
- Extract one attachment from the viewer and compare it with the original to confirm it opens, before you send the PDF on.
Limits and edge cases
- Not PDF/A-3b
- Not Merge
- Viewers without an attachments pane hide the files
- No size check, virus scan or file-type check; the bytes are embedded as they are
- The result is not an e-invoice container such as a Factur-X or ZUGFeRD package
- 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
- Attaching notes.txt adds an EmbeddedFiles entry named notes.txt
- Toggling convertToPdfA3b still writes a normal PDF
- Uploading `contract.pdf` plus `budget.xlsx` and `notes.txt` returns `contract.pdf` with three EmbeddedFiles entries; the page count is unchanged
- Submitting the PDF with no attachment files returns an error saying at least one attachments upload is required; add a file and run again
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
- Did convertToPdfA3b make PDF/A-3?
- No. The flag is ignored. Use PDF to PDF/A if you wanted Ghostscript PDFA=1/2, knowing that is not part 3.
- Are attached PDFs merged as pages?
- No. They sit in EmbeddedFiles. Merge concatenates pages.
- What if I forget the attachment files?
- The request fails with a bad-request error: at least one attachment upload is required.
- Is the embedded stream compressed specially?
- It is stored as application/octet-stream with a Size param. Do not assume PDF/A-3 associated files.
- Why can I not see my attachment?
- The file is embedded, but many browser viewers and phone previews do not show an attachments pane. Open the PDF in a desktop reader and look for the paperclip icon or an Attachments panel.
- Can I attach more than one file?
- Yes. Select several files in the attachments field and each is embedded as a separate entry named after the uploaded file.
- Does attaching change the pages of my PDF?
- No. Page content is untouched. The file size grows by roughly the size of the attachments.
- How do I get the attachment back out?
- Use your viewer's save-attachment command. Because the bytes are stored unchanged, the saved file matches the original upload.
- Does the attachment keep its name and extension?
- The upload's file name is stored in the Filespec as both `/F` and `/UF`, so a name such as `budget-2026.xlsx` appears as written.
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-attachments" \
-F "[email protected]" \
-F "attachments=@attachments" \
-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 Attachments for you with this skill: /skills/pdf123-add-attachments.md
Files are used only for this processing job and deleted automatically afterward.