October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run ScanOctober 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 Capture a Full-Page Screenshot in Firefox Headless Mode

Firefox documents headless command-line screenshots at chosen dimensions, while its full-page `--fullpage` helper runs in the Web Console. Learn the distinction, options and limitations.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Short answer: Firefox’s documented headless command-line screenshot captures a chosen window size, but Mozilla does not document a full-page flag for that command. For an explicitly full-page capture, Mozilla documents the Web Console helper :screenshot /absolute/path/page.png --fullpage. The documentation reviewed does not establish how to run that helper in a headless-only session.

What Firefox headless mode can capture from the command line

Firefox supports command-line screenshots with --screenshot. The switch itself implies headless operation, and --window-size sets the screenshot dimensions. For example:

As an Amazon Associate I earn from qualifying purchases.

firefox --headless --screenshot /absolute/path/page.png --window-size=1440,1000 https://example.com/

This saves a screenshot at the chosen dimensions; it is not a documented capture of the entire document. A tall window may show more vertical content, but Mozilla’s command-line reference does not say that it captures everything below the viewport. See Mozilla’s Command Line Parameters and the older Firefox headless-mode article.

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

The command-line reference says the screenshot is saved to the requested path, or to the working directory if no path is supplied. Use an absolute path when a script needs a predictable output location. Check firefox --help on the machine that will run the command: available options can vary by build and platform.

#1 Best Overall
Dell Optiplex 3060 Desktop Computer | Intel i5-8500 (3.2) | 32GB DDR4 RAM | 1TB SSD Solid State | Built in WiFi | Bluetooth | Windows 11 Professional | Home or Office PC (Renewed)
  • [INTEL POWERED CONTENT] - Built with a 8th Generation Hexa-Core Intel i5 and 32GB of DDR4 RAM; Modern, Windows 11 ready, with 4K support, Executive multitasking, media streaming and smooth, multi-tab web browsing; Perfect as an all-purpose multimedia computer; built for content creators; Plenty of RAM and Mass storage for photo and video editing powered by Intel HD 630
  • [LATEST WIRELESS TECH] - This Dell Desktop Computer easily connects to the internet through the Built In WiFi / Bluetooth
  • [SOLID STATE STORAGE] - This Dell Computer setup comes with an ultra-fast 1TB Solid State Drive (SSD); Setup as the primary boot device; Boot and load programs with lightning speed ; Additional expansion available
  • [BUY & OWN WITH CONFIDENCE] - From the world's largest Microsoft Authorized Refurbisher; Quality Guarantee and Free Tech Support; Award-winning Customer Service; | Support Sustainable Business
  • [MODERN HI-SPEED PORTS] - USB 3.0 (x4) | USB 2.0 (x4) | DisplayPort (x1) | HDMI Port (x1) | Audio Combo Jack (x1) | Audio Out (x1) | RJ-45 Ethernet (x1) | Internal SATA (x3)

Use the Web Console for Firefox’s documented full-page capture

Mozilla documents the DevTools Web Console helper :screenshot with the --fullpage option. It captures portions of the webpage outside the current window bounds:

:screenshot /absolute/path/page.png --fullpage

Enter this in Firefox’s Web Console; it is a Console helper, not a documented headless CLI flag. Mozilla’s documentation does not establish a headless-only way to invoke this helper. Consult Web Console Helpers, Taking screenshots and DevTools Tips for the documented Console workflow.

Rank #2
Dell Optiplex 7050 SFF Desktop PC Intel i7-7700 4-Cores 3.60GHz 32GB DDR4 1TB SSD WiFi BT HDMI Duel Monitor Support Windows 11 Pro Excellent Condition(Renewed)
  • Model: Dell OptiPlex 7050 Small Form Factor (SFF)
  • Processor: Intel Core i7-7700 3.60 GHz
  • Memory: 32GB DDR4 Ram
  • Storage: 1TB Solid State Drive (SSD) Fast Boot + Storage
  • Operating System: Windows 11 Pro (64-bit)

Other documented helper options

  • --delay waits a specified number of seconds before capturing; fractional values are supported.
  • --dpr sets the device pixel ratio.
  • --filename specifies a PNG filename.
  • --selector captures one CSS-selected element and its descendants.
  • --fullpage includes content outside the current window bounds.

If you capture again using an existing filename, Firefox overwrites the previous image. Choose a unique filename or move the earlier capture if you need to keep it.

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

Choose the method that matches the requirement

Method Where it runs What the cited documentation establishes Best fit
firefox --headless --screenshot ... Command line A screenshot at specified dimensions; no documented full-document flag Shell automation when a viewport-sized capture is sufficient
:screenshot ... --fullpage Firefox DevTools Web Console Capture beyond the current window bounds, with options such as delay, DPR and selector A documented whole-page capture when using the Console workflow

These are not interchangeable full-page methods: only the Web Console helper is explicitly documented with --fullpage. If your requirement is both command-line automation and a whole-document image, the cited Firefox documentation does not provide a headless-only procedure for that combination.

Rank #3
Sale
HP All-in-OneDesktop Computer, 16GB DDR5 RAM, Intel Quad-Cores, 128GB SSD, WiFi6, Keyboard & Mouse, Windows 11
  • IMMERSIVE 24 INCH DISPLAY: Experience stunning clarity on a Full HD IPS screen with ultra-thin bezels, offering a 90% screen-to-body ratio that makes everything from spreadsheets to streaming come alive with vibrant colors and crisp details.
  • POWERFUL INTEL PROCESSING: Tackle demanding tasks with ease thanks to the Intel processor and 16GB of high-speed memory, delivering smooth performance whether you're multitasking between applications or running productivity software.
  • GENEROUS STORAGE: Store all your important files, photos, and programs with blazing-fast solid state drive technology that ensures quick boot times, rapid file access, and plenty of space for your digital life.
  • ENHANCED PRIVACY AND COLLABORATION: Work confidently with the pop-up privacy camera that tucks away when not in use, plus dual microphones with noise reduction for crystal-clear video calls that keep you connected professionally.
  • ECO-CONSCIOUS DESIGN: Feel good about your purchase with an EPEAT Gold registered and ENERGY STAR certified computer that combines premium performance with responsible environmental manufacturing practices.

Make sure the page is ready before capturing

Dynamic pages may add content after initial navigation, including images loaded as the page scrolls. Mozilla’s cited documentation describes the helper’s delay option, but does not guarantee that a delay will load every lazy image or late-rendered element. If completeness matters, confirm the page has finished rendering and that the content you need is present before capture.

In the Console workflow, use --delay when a known short wait is appropriate. It is a timing control, not a guarantee that a site’s asynchronous work has completed. The headless CLI reference cited here does not document an equivalent full-page readiness mechanism.

Rank #4
Sale
Dell Optiplex 3050 SFF Desktop Computer PC, Intel Quad Core i5-6500 up to 3.6GHz, 16GB DDR4, 256GB SSD, WiFi, 4K Support, DP, HDMI, Windows 11 Pro 64 Bit (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 Certified Refurbished products on Amazon.com.
  • Dell Optiplex 3050 SFF Desktop computer PC, Intel Quad Core i5-6500 up to 3.6GHz, 16GB DDR4, 256GB SSD
  • Includes: USB Keyboard & Mouse, USB WiFi adapter, Microsoft office 30 days free trail.
  • Port: Front: USB 3.0(2), USB 2.0(2); Rear: DP, HDMI, USB 3.0(2), USB 2.0(2), RJ-45.
  • Support 4K (3840x2160) Dual display, makes it easy to connect two monitors at the same time, and you can expand working Windows, mirror content, or expand a single window across multiple monitors.

Troubleshooting

  • The CLI image stops at the visible area: --window-size sets dimensions; it is not a documented full-page option. Use the Web Console helper with --fullpage for the documented whole-page workflow.
  • Firefox rejects an option: run firefox --help and check the installed build’s available options. Command-line options vary by build and platform.
  • The output is missing or in an unexpected folder: specify an absolute output path. Without a requested path, the CLI saves to the working directory.
  • A later capture replaced an earlier image: the helper overwrites an existing filename. Use a different filename for each capture you need to retain.
  • The screenshot misses late or lazy content: verify the page is ready before capture; do not assume a delay alone guarantees that all dynamic content has loaded.
  • A headless run appears to hang: a Mozilla Support thread describes one user’s Firefox 125-era Linux hang and a moderator’s suggestion to try a dedicated profile. This is anecdotal troubleshooting context, not evidence that Firefox generally hangs or that a dedicated profile is a universal fix. See the Mozilla Support thread.
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 you need a screenshot without setting up Firefox capture steps, ScreenshotNeo offers a screenshot API and MCP server. One GET request returns an image or PDF. Example using cURL:

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 shot.webp

See the ScreenshotNeo API documentation for request options. ScreenshotNeo removes cookie banners, newsletter popups and chat widgets before capture; 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, and paid plans start at $5 for 3,000.

Sign up for ScreenshotNeo’s free plan to try 1,000 screenshots a month without a card.

Quick Recap

Bestseller No. 2
Dell Optiplex 7050 SFF Desktop PC Intel i7-7700 4-Cores 3.60GHz 32GB DDR4 1TB SSD WiFi BT HDMI Duel Monitor Support Windows 11 Pro Excellent Condition(Renewed)
Dell Optiplex 7050 SFF Desktop PC Intel i7-7700 4-Cores 3.60GHz 32GB DDR4 1TB SSD WiFi BT HDMI Duel Monitor Support Windows 11 Pro Excellent Condition(Renewed)
Model: Dell OptiPlex 7050 Small Form Factor (SFF); Processor: Intel Core i7-7700 3.60 GHz; Memory: 32GB DDR4 Ram
$392.99
SaleBestseller No. 4
Dell Optiplex 3050 SFF Desktop Computer PC, Intel Quad Core i5-6500 up to 3.6GHz, 16GB DDR4, 256GB SSD, WiFi, 4K Support, DP, HDMI, Windows 11 Pro 64 Bit (Renewed)
Dell Optiplex 3050 SFF Desktop Computer PC, Intel Quad Core i5-6500 up to 3.6GHz, 16GB DDR4, 256GB SSD, WiFi, 4K Support, DP, HDMI, Windows 11 Pro 64 Bit (Renewed)
Includes: USB Keyboard & Mouse, USB WiFi adapter, Microsoft office 30 days free trail.; Port: Front: USB 3.0(2), USB 2.0(2); Rear: DP, HDMI, USB 3.0(2), USB 2.0(2), RJ-45.
$150.00
Bestseller No. 5
Dell Windows 11 Desktop Computer OptiPlex 5060 | Intel Core i5-8500 Six Core (4.3GHz Turbo) | 16GB DDR4 RAM | 500GB SSD Solid State + 1TB HDD | WiFi + Bluetooth | Home or Office PC (Renewed)
Dell Windows 11 Desktop Computer OptiPlex 5060 | Intel Core i5-8500 Six Core (4.3GHz Turbo) | 16GB DDR4 RAM | 500GB SSD Solid State + 1TB HDD | WiFi + Bluetooth | Home or Office PC (Renewed)
Connectivity: Includes WiFi, Bluetooth, and LAN for wireless and wired connections; Memory: Features 16GB DDR4 RAM for smooth multitasking and performance
$255.00
Best Value
Dell Windows 11 Desktop Computer OptiPlex 5060 | Intel Core i5-8500 Six Core (4.3GHz Turbo) | 16GB DDR4 RAM | 500GB SSD Solid State + 1TB HDD | WiFi + Bluetooth | Home or Office PC (Renewed)
  • Connectivity: Includes WiFi, Bluetooth, and LAN for wireless and wired connections
  • Memory: Features 16GB DDR4 RAM for smooth multitasking and performance
  • Storage: Combines 500GB SSD and 1TB HDD for ample storage space
  • Graphics: Integrated Intel UHD Graphics 630 for crisp visuals and video playback
  • Design: Sleek desktop tower with black color and slim profile for modern look

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.

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
Outdated Drivers Are Slowing You DownFree scan - exact matches
Windows Errors? Fix Them Before They SpreadFree repair scan

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.