# \copypages

## Summary

The command \copypages is used to insert pages from another PDF

## Settings

 \copypages[...][...=...,...][...=...,...] [...] file marking on off offset dimension n number ...=...,... inherits from \setupexternalfigure

OptionExplanation
offset
 dimension this influences the scale of the included pages, higher values make the included page smaller (by a lot). This setting overrides any `scale` setting in the third argument, so probably should not be used unless you know exactly what the effect is.
n
 number Number of pages to include. If not specified, then all pages are included.

## Description

Insert pages from another PDF file as pages in the current document. This command differs from \filterpages because one cannot pick and choose, and from \insertpages because one cannot insert extra blank 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.

## Examples

### Example 1

```\copypages[file.pdf][n=30][scale=950]
```

Insert the first 30 pages of file.pdf, scaled down to 95%.