#  `move`

Move pages to a new location
## Usage
> pdftl `<input>` `move` `<source>` `{before|after}` `<target>`

## Details
Relocates pages within the document without duplication.

Semantics:
  - Pages matching `<source-spec>` are removed and reinserted at the target.
  - `<target>` is a page spec (target range) defining a single anchor position.
  - `before`: insert before the first page of the target range.
  - `after`: insert after the last page of the target range.

The following syntax is also supported:

```
pdftl in.pdf move @instructions.json output out.pdf
```

where `instructions.json` is a file containing valid JSON
`move` data. An example would be:

```
{
   "source_spec": "2-6even",
   "mode": "after",
   "target_spec": "end"
}
```
## Examples

> Simple Single Page: Move page 1 to the very end of a 10-page document.
```
pdftl in.pdf move 1 after 10 output out.pdf
```

> Moving a Block (Range): Move the first 5 pages to appear after page 8.
```
pdftl in.pdf move 1-5 after 8 output out.pdf
```

> Moving a Discontinuous List: Gather pages 1, 3, and 5 and place them before page 10.
```
pdftl in.pdf move 1,3,5 before 10 output out.pdf
```

> Reordering to the Front: Take the last page (e.g., page 10) and make it the cover page.
```
pdftl in.pdf move 10 before 1 output out.pdf
```

> 'Pulling' content back: Take page 20 and insert it in the middle of the document (after page 5).
```
pdftl in.pdf move 20 after 5 output out.pdf
```


**Tags**: pages, organization

*Source: pdftl.operations.move*

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

*Type: Operation*