---
name: "pdfattach"
section: "1"
platform: "linux"
package: "poppler"
version: "26.10.0-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pdfattach"
---

# pdfattach(1)

Portable Document Format (PDF) document embedded file creator (version 3.03)

## NAME

pdfattach - Portable Document Format (PDF) document embedded file creator (version 3.03)

## SYNOPSIS

**pdfattach** \[options\] *input-PDF-file file-to-attach output-PDF-file*

## DESCRIPTION

**Pdfattach** adds a new embedded file (attachment) to an existing Portable Document Format (PDF) file.

## OPTIONS

- **-replace**

  Replace embedded file with same name (if it exists)

- **-v**

  Print copyright and version information.

- **-h**

  Print usage information. (**-help** and **--help** are equivalent.)

## EXIT CODES

- 0

  No error.

- 1

  Error opening input PDF file.

- 2

  Error opening file to attach.

- 3

  Output file already exists.

- 3

  There is already an attached file with that name.

- 5

  Error saving the output file.

## AUTHOR

The pdfattach software and documentation are copyright 2019 The Poppler developers

## SEE ALSO

[**pdfdetach**(1)](/pdfdetach/1.md), [**pdfimages**(1)](/pdfimages/1.md), [**pdfinfo**(1)](/pdfinfo/1.md), [**pdftocairo**(1)](/pdftocairo/1.md), [**pdftohtml**(1)](/pdftohtml/1.md), [**pdftoppm**(1)](/pdftoppm/1.md), [**pdftops**(1)](/pdftops/1.md), [**pdftotext**(1)](/pdftotext/1.md) [**pdfseparate**(1)](/pdfseparate/1.md), [**pdfsig**(1)](/pdfsig/1.md), [**pdfunite**(1)](/pdfunite/1.md)