#  `import_images`

Import edited images from a directory using a JSON manifest
## Usage
> pdftl `<input>` `import_images` `<dir>` `[manifest=<manifest.json>]` `[quality=<q>]` `output` `<out.pdf>`

## Details
The `import_images` operation reads a JSON manifest (generated by [`export_images`](<export_images.md>)) and
overwrites the corresponding internal PDF image streams with the edited files from a
directory.

If an image file in the directory has not been modified (its MD5 hash matches the original
export hash), it is safely skipped to prevent unnecessary re-encoding and generation loss.

### Arguments

* `<directory>`: **(Required)** The directory containing the edited images.
* `[manifest=<manifest.json>]`: Path to the JSON manifest. If omitted, defaults to
  `<directory>/manifest.json`. Specify `manifest=-` to read the manifest from standard input.
* `[quality=<q>]`: The JPEG compression quality (1-100) used when writing back lossy
  images. (Default: 75)
## Examples

> Import edited images from 'my_images/' using 'my_images/manifest.json' and save.
```
pdftl in.pdf import_images my_images output out.pdf
```

> Import edited images using a custom manifest location.
```
pdftl in.pdf import_images edited_assets manifest=custom_manifest.json output out.pdf
```


**Tags**: in_place, images, import, replace

*Source: pdftl.operations.export_import_images*

*Read online: [https://pdftl.readthedocs.io/en/latest/operations/import_images.html](https://pdftl.readthedocs.io/en/latest/operations/import_images.html)*

*Type: Operation*