October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PCOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk4 min

How to Convert a Webpage to PDF With Page Numbers Using Playwright

Use Playwright’s page.pdf() with a self-contained footer template to add current and total page numbers to a webpage PDF.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Use Playwright’s page.pdf() with displayHeaderFooter: true and a footer template containing pageNumber and totalPages. The example below saves an A4 PDF with a numbered footer. Playwright generates PDFs with print CSS by default; choose screen media first if that is what you need.

Generate a numbered PDF with Playwright

Install Playwright in your project and use the browser binaries associated with that Playwright version. The script navigates to a page, writes the PDF to page.pdf, and closes the browser even if capture fails.

As an Amazon Associate I earn from qualifying purchases.

const { chromium } = require('playwright');

(async () => {
  const browser = await chromium.launch();
  try {
    const page = await browser.newPage();
    await page.goto('https://example.com');

    await page.pdf({
      path: 'page.pdf',
      format: 'A4',
      displayHeaderFooter: true,
      margin: {
        top: '20mm',
        right: '15mm',
        bottom: '20mm',
        left: '15mm',
      },
      footerTemplate: `
        <div style="width: 100%; font-size: 9px; padding: 0 15mm; text-align: right;">
          <span class="pageNumber"></span> / <span class="totalPages"></span>
        </div>
      `,
    });
  } finally {
    await browser.close();
  }
})();

Replace https://example.com with the page you want to capture. The footer displays values such as “1 / 4”: Playwright substitutes the current page number and total page count for the two documented classes.

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

How page numbering and footer templates work

Header and footer output is disabled unless you set displayHeaderFooter: true. Add a footerTemplate for numbering at the bottom or a headerTemplate for content at the top. The available substitution classes are pageNumber, totalPages, date, title, and url.

#1 Best Overall
HP Stream 14" HD Laptop, Intel Processor N150, 4GB RAM, 128GB UFS, Intel Graphics, Webcam, Wi-Fi 6, Copilot, Fast Charge, Windows 11, Silver (Renewed)
  • 【14" HD Display】The business and leisure activities will undoubtedly benefit from the mesmerizing clarity and brilliance.
  • 【Intel Processor N150】Enjoy seamless multitasking, consistent performance, and significant energy conservation, making it an outstanding choice for your everyday computing needs.
  • 【4GB DDR4 RAM】Get high-bandwidth performance for resource-intensive tasks. Run multiple applications at once and stay responsive.【128GB UFS】 Delivers blazing boot-up speed and enhanced storage capabilities. Effortlessly access your extensive digital library with ease.
  • 【Intel Graphics】Enjoy vibrant colors and sharp details that bring your everyday content to life. 【720p HD Camera】Provides high quality video calls, virtual meetings and online interactions.
  • 【Windows 11 S】Unlock endless possibilities with a user-friendly operating system, tailored to your needs.【Dimensions & Weight】12.76 x 8.86 x 0.71 inches, 3.24 lbs.【Ports】1x USB Type-C, 2x USB Type-A, 1x Headphone/microphone combo, 1x Media card reader, 1x HDMI 1.4b, 1x AC Smart pin. Wi-Fi 6, Bluetooth, Webcam.

Templates are separate from the page’s normal document styling: scripts inside them are not evaluated, and page styles do not apply. Keep the template self-contained and use inline styles for its appearance. The example places the number at the right; change its inline alignment or text if your layout calls for another presentation.

Set margins and paper size deliberately

PDF margins default to zero. Specify enough top or bottom margin to keep a header or footer clear of the page content; the example uses 20 mm vertically and 15 mm horizontally as adjustable choices, not as required values. If the footer is crowded or overlaps content, increase the bottom margin and review the page’s print layout.

Rank #2
Lavsoul 4K Webcam with Microphone for PC & Streaming Computer Camera
  • ULTRA HD 4K CLARITY: Stand out in every video call with breathtaking 4K video at 30fps or smooth 1080p at 60fps. Powered by a premium 1/2.5" CMOS sensor and a wide f/1.78 aperture, this webcam captures every detail with vibrant color and stunning low-light performance-so you always look your best
  • FAST AUTOFOCUS & SMART LIGHT CORRECTION: No more blurry moments with this webcam for PC. Advanced Phase Detection Auto Focus (PDAF) locks onto your face instantly and keeps you sharp-even when you move. Built-in light correction adapts to your environment, balancing brightness and contrast for a flawless image in dim rooms or bright spaces
  • DUAL NOISE-CANCELING MICS: Speak with confidence using this webcam with microphones. Dual microphones with intelligent noise-canceling tech isolate your voice and reduce background noise-suitable for webinars, live streams, team meetings, and virtual interviews
  • WIDE-ANGLE LENS & FLEXIBLE MOUNTING OPTIONS: Capture more of your world with an 80 field of view and full 360 swivel rotation. Whether this streaming webcam is mounted on a laptop, monitor, or tripod, it allows you to find the right angle for any setup
  • BUILT-IN PRIVACY COVER & PLUG-AND-PLAY SIMPLICITY: Protect your privacy with a secure sliding lens cover that blocks the camera when not in use. Setup is a breeze-just plug into any USB-A port and start streaming, chatting, or recording instantly. The USB webcam is compatible with Zoom, Microsoft Teams, Skype, OBS Studio, and all major platforms across Windows, macOS, and Linux

format chooses a paper size; Letter is the API default, and A4 and A5 are among the documented formats. When format is set, it takes priority over width and height. If the document defines its own CSS @page size and that should control output, set preferCSSPageSize: true; otherwise, content is scaled to fit the PDF paper size.

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

Choose print or screen styles

page.pdf() uses print CSS media by default, which is usually appropriate for documents designed for printing. To render the page with its screen styles instead, emulate screen media before generating the PDF:

Rank #3
Dell Latitude 5410 14-Inch 1920 x 1080 FHD Laptop, Core i5-10210U, 32GB DDR4 RAM, 1TB M.2 NVMe SSD, Thunderbolt, HDMI, Windows 11 Pro, Webcam, Business Laptop (Renewed)
  • This Certified Refurbished product is tested and certified to look and work like new. The refurbishing process includes functionality testing, basic cleaning, inspection, and repackaging. The product ships with all relevant accessories, a minimum 90-day warranty, and may arrive in a generic box. Only select sellers who maintain a high performance bar may offer 1Certified Refurbished products on Amazon.com.
  • Powerful 10th Gen Intel Core i5: Features a quad-core i5-10210U processor (up to 4.2GHz Turbo Boost) for smooth multitasking and business productivity.
  • High-Speed Memory & Storage: 32GB DDR4 RAM ensures seamless performance, while the 1TB M.2 NVMe SSD provides ultra-fast boot-up and file access.
  • Stunning 15.6-inch FHD Display: Enjoy crisp visuals with 1920x1080 resolution.
  • Enhanced Connectivity: Features Wi-Fi, Bluetooth, Type-C, HDMI, and Thunderbolt for versatile connectivity options.
await page.emulateMedia({ media: 'screen' });
await page.pdf({ path: 'page.pdf', displayHeaderFooter: true, footerTemplate: '<div><span class="pageNumber"></span> / <span class="totalPages"></span></div>' });

The choice affects the page content and layout, not the numbering mechanism. Keep displayHeaderFooter enabled and the page-number classes in the template in either case.

Other useful PDF options

  • landscape changes page orientation.
  • scale adjusts the scale of the page contents.
  • printBackground: true includes background graphics; it defaults to false.
  • pageRanges selects which pages to include.
  • preferCSSPageSize: true lets CSS @page sizing take priority over PDF paper-size options.

For color-sensitive output, note that PDF generation modifies colors for printing by default. The API reference points to the CSS property -webkit-print-color-adjust when exact colors are needed.

Rank #4
10.1 Inch Mini Netbook, Quad-Core Processor Laptop Computer, 2GB Memory 64GB Storage Android 12 Portable Notebook Built-in Webcam, WiFi & Bluetooth Keyboard & Mouse for Home Schooling & Office Work
  • 【Efficient Quad-Core Performance】 Powered by a 1.8GHz Quad-Core processor, this mini laptop ensures smooth multitasking. With 2GB RAM and 64GB ROM (expandable to 1TB), it handles daily work and online tasks with ease.
  • 【10.1" HD IPS Display & GMS Support】 Featuring a 1280x800 HD IPS screen, this cheap laptop delivers vibrant visuals. Pre-installed with Android OS and GMS, you get direct access to the Google Play Store for apps.
  • 【Ultra-Portable & Lightweight Design】 Weighing only 1.76 lbs, this Blue computer is designed for mobility. Its compact form makes it an ideal companion for students and professionals for home schooling or trips.
  • 【Versatile Connectivity Options】 Stay productive with dual USB 2.0 ports, a headphone jack, and a TF card slot. This computer for kids and adults features built-in Wi-Fi and Bluetooth for stable connections.
  • 【Complete All-in-One Bundle】 This kid laptop kit includes the laptop, carrying bag, mouse, mouse pad, and power adapter. It is the perfect ready-to-use set for online classes, remote work, and entertainment.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot common problems

  • No page numbers appear: Confirm displayHeaderFooter: true is set and the template uses the exact classes pageNumber and totalPages.
  • The footer overlaps the page: Margins default to zero. Increase the bottom margin for a footer, or the top margin for a header, and check the resulting layout.
  • The PDF looks different from the browser: PDF generation uses print media by default. Call page.emulateMedia({ media: 'screen' }) before page.pdf() if screen styling is intended.
  • Background colors or images are missing: Set printBackground: true if the PDF needs page background graphics.
  • CSS page dimensions are ignored: Set preferCSSPageSize: true when CSS @page sizing should take priority.
  • A browser executable is missing or incompatible: Playwright versions require specific browser binary versions. Use the binaries associated with the installed Playwright version and consult documentation matching that version if behavior or option support differs.

Or skip the browser setup

ScreenshotNeo can return a PDF from one GET request. Its PDF options include paper size, margins, landscape orientation, and page ranges. For example, this saves a PDF of the target URL:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://example.com -o page.pdf

See the ScreenshotNeo API documentation for request options. ScreenshotNeo accepts cookie and consent banners like a visitor and removes 60+ known consent platforms, newsletter popups, and chat widgets before capture; each cleanup step can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits cost nothing, with response headers indicating the page verdict and whether the request was billed. Its MCP server lets AI agents use screenshot and PDF tools. The free plan includes 1,000 shots a month with no card; paid plans start at $5 for 3,000 shots. Learn more at ScreenshotNeo.

Sign up for ScreenshotNeo: get 1,000 free screenshots a month with no card.

Frequently Asked Questions

Can I put the page number in a header instead of a footer?

Yes. Enable header and footer display and use the same page-number classes in a headerTemplate.

Can I add a total page count beside the current page?

Yes. Put <span class="pageNumber"></span> and <span class="totalPages"></span> in the header or footer template.

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.

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

Leave a Reply

Your email address will not be published. Required fields are marked *

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

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.