# \insertpages

## Syntax (autogenerated)

 \insertpages[...][...,...][...=...,...] [...] file [...,...] number width dimension n number category name

## Syntax

 \insertpages[...][...][...] [...] filename [...] places to insert blank pages [...] figure options, see \useexternalfigure

## Description

Insert pages from another PDF file as pages in the current document. The second argument causes ConTeXt to insert blank pages after specific inserted pages.

Please note that the inserted pages will be placed on your ConTeXt pages like a new "layer", or floating object. This means that your existing headers, footers, crop marks will still be printed on top of or behind the inserted pages.

If you want to insert pages as completely independent pages between your existing ConTeXt pages, use \startpagefigure.

## Page Scaling

By default, pages are scaled to \textheight. If you want a different scaling, you need to define a new external figure, such as in:

```\setupexternalfigure[location=default]
\defineexternalfigure[foo][width=.5\textwidth]

\starttext \showframe

\insertpages[cow.pdf][category=foo]

\stoptext
```

This feature will be implemented in next beta (July 10th, 2016).

## Example

This inserts the first 30 pages of the file.pdf and adds a blank page after the first and the third page, inserting 32 pages in all.

```\insertpages[file.pdf][1,3][n=30,width=18cm]
```

• \filterpages to pick and choose PDF pages to insert
• \copypages to insert pages from 1 to n from another PDF
• \insertpages to insert pages from 1 to n from another PDF, with extra blank pages at specific locations
• \startpagefigure to insert a figure as a separate page
• \setuparranging to arrange the document's pages on the sheet

All issues with: