Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

Puppeteer can generate PDFs in named paper formats such as Letter and A4, or in custom dimensions. Use the format option for a listed size; use width and height for a custom size. If the page defines its own size with CSS @page, set preferCSSPageSize to decide whether that CSS size or the PDF options take priority.

Which paper sizes does Puppeteer support?

Puppeteer’s PDFOptions.format accepts the named formats below. Dimensions are the figures in the Puppeteer PaperFormat reference, version 25.12.0 at retrieval; treat them as Puppeteer’s API values, not as independent printer or standards guidance. See the Puppeteer PaperFormat reference.

Format Dimensions (inches) Dimensions (centimeters)
Letter 8.5 × 11 21.59 × 27.94
Legal 8.5 × 14 21.59 × 35.56
Tabloid 11 × 17 27.94 × 43.18
Ledger 17 × 11 43.18 × 27.94
A0 33.1102 × 46.811 84.1 × 118.9
A1 23.3858 × 33.1102 59.4 × 84.1
A2 16.5354 × 23.3858 42 × 59.4
A3 11.6929 × 16.5354 29.7 × 42
A4 8.2677 × 11.6929 21 × 29.7
A5 5.8268 × 8.2677 14.8 × 21
A6 4.1339 × 5.8268 10.5 × 14.8

How do I set A4 or Letter?

Pass the format name to page.pdf(). The option is named format; use Puppeteer’s documented format spelling, such as 'A4' or 'Letter'.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  try {
    const page = await browser.newPage();
    await page.goto('https://example.com', { waitUntil: 'networkidle0' });
    await page.pdf({ path: 'output.pdf', format: 'A4' });
  } finally {
    await browser.close();
  }
})();

Replace 'A4' with 'Letter' or another listed format as needed. If you omit format, Puppeteer documents Letter as the default. When both format and explicit dimensions are provided, format takes priority over width and height.

#1 Best Overall
Amazon Basics Multipurpose Copy Printer Paper, 8.5 x 11 Inches, 20 lb, 92 Bright, White, 1 Ream (500 Sheets), Jam-Free
  • 1 ream (500 sheets) of 8.5 x 11 white copier and printer paper for home or office use
  • Multipurpose letter size copy paper works with laser/inkjet printers, copiers and fax machines
  • Smooth 20lb weight paper for consistent ink and toner distribution; dries quickly and resists paper jams
  • Bright white paper (92 GE; 104 Euro) offers great contrast for crisp printing and vivid color
  • Virgin copy paper providing professional quality results; acid-free to prevent yellowing

How do custom PDF dimensions work?

For a size not in the named list, provide both width and height. Each accepts a number or a string with a unit. Explicit units make the intended measurement clear.

await page.pdf({
  path: 'custom-size.pdf',
  width: '210mm',
  height: '297mm'
});

This example sets page dimensions directly. Do not also pass format if you intend the custom dimensions to control the page size, because the named format wins when both are supplied. The accepted PDF option behavior is documented in Puppeteer’s PDFOptions interface.

Rank #2
HP Printer Paper | 8.5 x 11 Paper | Copy &Print 20 lb | 1 Ream Case - 500 Sheets| 92 Bright | FSC Certified | 200060
  • HP Papers is sourced from renewable forest resources and has achieved production with 0% deforestation in North America. Each ream is wrapped in a polyurethane coated paper wrapper to protect the cut sheets from moisture damage
  • Sheet size – 8.5 x 11; Thickness – 20 pounds; Brightness – 92 bright white
  • HP Copy&Print20 20 pounds printer paper is Forest Stewardship Council (FSC) certified and contributes toward satisfying credit MR1 under LEED (Leadership in Energy and Environmental Design)
  • All HP Papers provide premium performance on HP equipment, as well as on all other printer and copier equipment; 100% satisfaction guaranteed; ColorLok technology provides more vivid colors, bolder blacks and faster drying
  • Superior quality, reliability, and dependability for high-volume printing at home, at school and in the office; HP Copy&Print20 print and copy paper prevents yellowing over time to ensure a long-lasting appearance for added archival quality

Should CSS @page or Puppeteer options control the size?

A page can declare a paper size in print CSS, for example with an @page rule. Puppeteer’s preferCSSPageSize determines whether that declaration takes priority over the dimensions or format in the PDF options. Its default is false; in that case Puppeteer scales page content to fit the selected paper size.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
await page.pdf({
  path: 'css-sized.pdf',
  format: 'A4',
  preferCSSPageSize: true
});

Set this to true when the document’s own @page rule should determine the paper size. Leave it false when the size passed to Puppeteer should control the output and the content should be fitted to it. The option’s priority behavior is described in the PDFOptions reference.

Rank #3
Sale
Hammermill A4 Paper, 20 lb Copy Paper (210mm x 297mm) - 1 Ream (500 Sheets) - 92 Bright, Made in the USA
  • HAMMERMILL’S BEST SELLING PRINTER PAPER – You will receive one ream of paper with 500 sheets of 20lb, 92 bright, A4 white copy paper
  • 99.99% JAM-FREE PRINTER PAPER - Everyone hates paper jams...You can trust Hammermill paper quality to keep your printer running smoothly. Scroll down to view the Product Description for details
  • COLORLOK TECHNOLOGY INCLUDED - Colors on Hammermill copy paper are 30% brighter; blacks are up to 60% bolder and inks dry 3 times faster for less smearing. Acid-free Hammermill paper ensures long-lasting archival quality
  • MADE IN USA - Hammermill copying and printing papers are 100% made in the USA, helping to support 2. 4 million sustainable forestry jobs in America, including family tree farmers. Hammermill is more than just paper
  • MAKE SURE IT’S ORIGINAL HAMMERMILL QUALITY - Look for “Ships from and sold by ” at the top of the page, under the product title

Which other PDF options affect the result?

  • landscape switches orientation; its default is false. It does not change which named formats exist.
  • margin controls page margins; the documented default is none.
  • scale scales the page content, defaults to 1, and accepts values from 0.1 to 2.
  • printBackground includes background graphics when enabled; its default is false.

These options change how content is presented on the page; they do not replace selecting the page dimensions. Consult the PDFOptions reference for the complete option details.

Why does the PDF look different from the browser?

page.pdf() uses print CSS media by default. If the page is designed for screen media and you want that styling for the PDF, switch media before generating it:

Rank #4
Sale
Premium Printer Paper, A4 (8.3"x 11.7") Blank Copy Paper, Unpunched, Blank Papers, 28lb Bond/100gsm, 50 Sheets/100 Pages
  • A4 BLANK PAPER - 8.3"x 11.7" printer paper, 50 sheets/100 pages white paper, Convenient to record your work and study
  • UNPUNCHED - This A4 blank paper put in notebook, this paper is 210mm x 297mm, Inkjet, Laser, & Copier Printer Compatible.
  • HIGH QUALITY PAPER - Copy paper with100gsm white paper with smooth texture for smooth writing. Heavy-weight, acid-free filler paper, so that ink won't bleed through. Refills paper responds well to pencils, fountain pens, ball-point pen, gel pen etc
  • PRINT AND USE - Pre-punched blank paper ready to print any A4 planner templates you like. Suitable for printer has different paper sizes
  • GREATL FOR - Blank paper works perfectly with binder notebook planner, ideal for sketching, drawing, creative writing, work records, bullet journaling, meeting record, class notes, travel diary, poem writing, doodles, project notebook for work, home or school
await page.emulateMediaType('screen');
await page.pdf({ path: 'screen-style.pdf', format: 'A4' });

Print output may also modify colors. Puppeteer documents -webkit-print-color-adjust for forcing exact colors. Check the page’s print styles and color rules if backgrounds or colors differ from the browser view. See Puppeteer’s Page.pdf() documentation.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup

If your task is capturing a webpage as an image or PDF rather than configuring Puppeteer’s PDF generation, ScreenshotNeo provides a screenshot API and MCP server. A single GET request can return a PNG, JPEG, WebP, or PDF; it can also handle consent banners and other overlays before capture.

For example, request a PDF by selecting the PDF output option supported by the API:

Quick Recap

Bestseller No. 1
Amazon Basics Multipurpose Copy Printer Paper, 8.5 x 11 Inches, 20 lb, 92 Bright, White, 1 Ream (500 Sheets), Jam-Free
Amazon Basics Multipurpose Copy Printer Paper, 8.5 x 11 Inches, 20 lb, 92 Bright, White, 1 Ream (500 Sheets), Jam-Free
1 ream (500 sheets) of 8.5 x 11 white copier and printer paper for home or office use; Virgin copy paper providing professional quality results; acid-free to prevent yellowing
$6.97
Bestseller No. 2
HP Printer Paper | 8.5 x 11 Paper | Copy &Print 20 lb | 1 Ream Case - 500 Sheets| 92 Bright | FSC Certified | 200060
HP Printer Paper | 8.5 x 11 Paper | Copy &Print 20 lb | 1 Ream Case - 500 Sheets| 92 Bright | FSC Certified | 200060
Sheet size – 8.5 x 11; Thickness – 20 pounds; Brightness – 92 bright white
$6.97
Bestseller No. 5
Amazon Basics Multipurpose Copy Printer Paper, 20 lb, 8.5 x 11 Inches, 3 Reams (1,500 Sheets), 92 Bright White for Home Use
Amazon Basics Multipurpose Copy Printer Paper, 20 lb, 8.5 x 11 Inches, 3 Reams (1,500 Sheets), 92 Bright White for Home Use
Virgin copy paper providing professional quality results; acid-free to prevent yellowing
$21.96
Best Value
Amazon Basics Multipurpose Copy Printer Paper, 20 lb, 8.5 x 11 Inches, 3 Reams (1,500 Sheets), 92 Bright White for Home Use
  • 3 ream case (1,500 sheets) of 8.5 x 11 white copier and printer paper for home or office use
  • Multipurpose letter size copy paper works with laser/inkjet printers, copiers and fax machines
  • Smooth 20lb weight paper for consistent ink and toner distribution; dries quickly and resists paper jams
  • Bright white paper (92 GE; 104 Euro) offers great contrast for crisp printing and vivid color
  • Virgin copy paper providing professional quality results; acid-free to prevent yellowing
curl -G "https://api.screenshotneo.com/v1/shot" 
  -d access_key=YOUR_API_KEY 
  --data-urlencode url=https://example.com 
  -d format=pdf 
  -o page.pdf

See the ScreenshotNeo documentation for the exact request parameters and output options. Cookie banners, popups, and chat widgets are removed before the shot; bot checks, blank pages, and failed loads are never billed. Its MCP server lets AI agents take screenshots. The free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000. Sign up for free.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.