[Home](./index.md) > [puppeteer](./puppeteer.md) > [PDFOptions](./puppeteer.pdfoptions.md)
## PDFOptions interface
Valid options to configure PDF generation via [Page.pdf()](./puppeteer.page.pdf.md).
Signature:
```typescript
export interface PDFOptions
```
## Properties
| Property | Type | Description |
| --- | --- | --- |
| [displayHeaderFooter?](./puppeteer.pdfoptions.displayheaderfooter.md) | boolean | (Optional) Whether to show the header and footer. |
| [footerTemplate?](./puppeteer.pdfoptions.footertemplate.md) | string | (Optional) HTML template for the print footer. Has the same constraints and support for special classes as [PDFOptions.headerTemplate](./puppeteer.pdfoptions.headertemplate.md). |
| [format?](./puppeteer.pdfoptions.format.md) | [PaperFormat](./puppeteer.paperformat.md) | (Optional) |
| [headerTemplate?](./puppeteer.pdfoptions.headertemplate.md) | string | (Optional) HTML template for the print header. Should be valid HTML with the following classes used to inject values into them: - date
formatted print date- title
document title- url
document location- pageNumber
current page number- totalPages
total pages in the document |
| [height?](./puppeteer.pdfoptions.height.md) | string \| number | (Optional) Sets the height of paper. You can pass in a number or a string with a unit. |
| [landscape?](./puppeteer.pdfoptions.landscape.md) | boolean | (Optional) Whether to print in landscape orientation. |
| [margin?](./puppeteer.pdfoptions.margin.md) | [PDFMargin](./puppeteer.pdfmargin.md) | (Optional) Set the PDF margins. |
| [omitBackground?](./puppeteer.pdfoptions.omitbackground.md) | boolean | (Optional) Hides default white background and allows generating pdfs with transparency. |
| [pageRanges?](./puppeteer.pdfoptions.pageranges.md) | string | (Optional) Paper ranges to print, e.g. 1-5, 8, 11-13
. |
| [path?](./puppeteer.pdfoptions.path.md) | string | (Optional) The path to save the file to. |
| [preferCSSPageSize?](./puppeteer.pdfoptions.prefercsspagesize.md) | boolean | (Optional) Give any CSS @page
size declared in the page priority over what is declared in the width
or height
or format
option. |
| [printBackground?](./puppeteer.pdfoptions.printbackground.md) | boolean | (Optional) Set to true
to print background graphics. |
| [scale?](./puppeteer.pdfoptions.scale.md) | number | (Optional) Scales the rendering of the web page. Amount must be between 0.1
and 2
. |
| [width?](./puppeteer.pdfoptions.width.md) | string \| number | (Optional) Sets the width of paper. You can pass in a number or a string with a unit. |