Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversOctober 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 PC×
Skip to content
World desk7 min

How to Take a Full Website Screenshot with wkhtmltoimage in WordPress

A practical guide to capturing a WordPress page with wkhtmltoimage, including command syntax, output checks, JavaScript timing and Qt WebKit caveats.

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.

To capture a WordPress page with wkhtmltoimage, run the command-line tool from a computer or server that can reach the page, choose an output format and viewport width, and save the result to an image file. WordPress does not provide a special screenshot mode for it: the renderer loads the page like a web document and creates the image. A basic PNG command is:

wkhtmltoimage --format png --width 1280 https://example.com/ page.png

Replace the example URL and adjust the width for the layout you need. Then inspect the resulting image: older Qt WebKit rendering can differ from a current browser, and a command completing successfully does not guarantee that every image or script has loaded.

As an Amazon Associate I earn from qualifying purchases.

What wkhtmltoimage does—and what “full website screenshot” means

wkhtmltoimage is a command-line renderer from the wkhtmltopdf project. The project describes it as a headless tool using Qt WebKit, so it can render without a desktop display service. It can take a URL or HTML input and produce an image; it is not a WordPress plugin or a setting inside the WordPress dashboard. See the upstream project and its usage documentation.

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

In this guide, a full-page capture means an image of the page’s document rather than just the initially visible viewport. The output is still a rendering at a chosen viewport width, not a pixel-for-pixel guarantee of what every visitor’s browser will show. The reviewed documentation does not establish one universally correct full-page command or width for WordPress sites.

#1 Best Overall
Tworider Screen Repair Kit & Window Screen Replacement Kit with Spline Roller Tool, Spline Removal Hook, Screen Cutter - Easy to Use 5-in-1 Tool for Screen Door Repair, Windows, Patio & Sliding Doors
  • 🌟 All-in-One Screen Solution: Essential for seamless window screen replacement & repairs. This versatile screen repair kit Perfect for DIY screen spline insertion, frame rolling, and mesh tightening – your go-to tool for screen for windows projects.
  • 🔷 Dual Roller Innovation: Features convex (round) & concave (grooved) steel rollers. The concave roller prevents delicate screen tearing during spline rolling, while the convex wheel ensures tight sealing. Ultimate precision for window screen tool tasks.
  • ❖ Ergonomic Wooden Handle: Solid hardwood handle delivers superior comfort during prolonged screen roll installation. Non-slip grip reduces hand fatigue when replacing window screens. Durable steel bearings ensure smooth roller rotation – ideal for screen door repair marathons.
  • 🔧Spline Tool + Screen Roller Tool: Offers three roller diameter options for selection. When replacing window screens, choose the corresponding roller based on the Spline specifications to completely eliminate tool size mismatch issues.
  • 💎 Pro-Grade Durability: Carbon-steel rollers withstand aggressive spline rolling without deformation. your lifetime screen repair tool investment.

Install and check the command-line tool

Install a wkhtmltoimage build suitable for the operating system where you will run it. The project documents downloading a precompiled binary or building from source. Since packaged builds can differ, confirm the installed binary and its available options before relying on a command in automation.

  1. Install the binary using the project’s distribution guidance or your operating system’s package source.

  2. Check that the command is on your executable path by running wkhtmltoimage --version. If that build does not support the version flag, inspect its help output with wkhtmltoimage --help.

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  3. Read the options shown by the actual installed build; do not assume every package exposes identical behavior.

The upstream GitHub repository is archived, so check compatibility of the binary available for your platform before adopting it for a new production workflow. Do not assume a package is the latest or actively maintained merely because it is available from a distribution.

Capture a WordPress page as a PNG

Run the command on a machine that can access the page and its linked resources. For a public page, substitute its full URL and choose a width that suits the intended output:

Rank #2
King&Charles Screen Roller Tool 2in1-Bearing Roller+Hook to Replace Mesh
  • ⭐【QUALITY MATERIALS】- Solid wood handle + double carbon steel bearing metal wheels, heavy beech wood handles are hard and crack-free, thickened and enlarged metal convex and concave double wheels, each of them is finely crafted and durable, suitable for the replacement of aluminum alloy plastic steel doors and windows of any specification.
  • ⭐【SCREEN TOOLS SET】- The screen rolling tool has two different wheels, cams and recessed rollers, which can help you get the job done better and faster. Screen roller is compact and easy to carry,which is can solve your problem well. Every one is meticulously crafted and durable, A good helper for replacing screens at home.
  • ⭐【EASY TO USE】- Installing a screen with a screen rolling tool makes the job much easier. This essential tool is comfortable in the hand and the wheels turn smoothly to roll the screen and spline into the frame. It’s extremely economical and adds great value to big and small screen repair jobs.
  • ⭐【ERGONOMIC HANDLE】- The wood handle has ergonomic design, it is easy to hold. wooden handle and steel convex and concave roller wheels,the steel wheels of our screen rolling tool is smooth The hooks are sharp and the aged battens can be hooked out.
  • ⭐【CONVEX & CONCAVE 】– The combination screen rolling tool has a 1-5/16" x 3/32" convex (round edge) steel roller at one end and a 1-5/16" x 3/32" concave (grooved edge) steel roller at the opposite end.
wkhtmltoimage --format png --width 1280 https://example.com/ page.png

Here, --format png selects PNG output, --width 1280 sets the rendering viewport width, the URL is the page to load, and page.png is the output filename. The width of 1280 is an example, not a recommended universal setting. Use the width that matches the page layout or downstream use, then check whether the screenshot is clipped or rendered differently than expected.

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

The command-line documentation also describes an input HTML file as an option. If you use local HTML rather than a URL, the page’s linked files and local-file permissions matter; see the local-file guidance below.

Choose format, viewport and rendering options

Image format

The example explicitly requests PNG. The tool supports image output formats, but the exact formats available can depend on the build. Check the installed tool’s help and use an output extension that matches the selected format. The reviewed material does not establish a universal best format or quality setting for every use.

Viewport width

The viewport width can affect responsive layouts: a WordPress theme may rearrange navigation, columns, and images at different widths. Select a width deliberately and inspect the output instead of treating the command’s example value as a site standard.

JavaScript delay

The documented CLI enables JavaScript by default and sets its JavaScript delay to 200 milliseconds. If the page fills in content after scripts run, test a longer delay, such as:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
wkhtmltoimage --format png --width 1280 --javascript-delay 1500 https://example.com/ page.png

A longer delay only makes the renderer wait; it does not prove that a particular application has finished rendering. Compare the image with the page in a browser and adjust only when the page’s behavior warrants it. The project’s release history says version 0.12.2.1 fixed an earlier issue where wkhtmltoimage ignored the JavaScript-delay and window-status options; that historical note does not establish identical behavior for every packaged binary. See the release history.

Rank #3
King&Charles Versatile Screen Roller Tool, 3pcs Different Roller+Hook+Trim
  • --- 𝐏𝐀𝐓𝐄𝐍𝐓 𝐀𝐏𝐏𝐋𝐈𝐄𝐃 𝐅𝐎𝐑---
  • 🏡【𝐊𝐢𝐧𝐠&𝐂𝐡𝐚𝐫𝐥𝐞𝐬 𝐑&𝐃 𝐈𝐧𝐭𝐞𝐧𝐭𝐢𝐨𝐧】Versatile Screen Tool - combines the core functions of multi-size roller, hidden hooks, and replaceable blades, and designed this multifunctional screen tool. It solves the problems of traditional screen installation tools with single functions, lack of safety and adaptability. It truly realizes multiple uses of one tool, making screen replacement time-saving, labor-saving, and worry-free. One-time purchase can meet your installation or replacement needs.
  • 🏡【𝟑 𝐒𝐢𝐳𝐞𝐬 𝐈𝐧𝐭𝐞𝐫𝐜𝐡𝐚𝐧𝐠𝐞𝐚𝐛𝐥𝐞 𝐑𝐨𝐥𝐥𝐞𝐫𝐬】Flexible Adaptation - In view of the differences in thickness of different window splines, we gift the roller into three specifications: Convex 0.13", Concave 0.13", and Concave 0.18", ensuring perfect matching with the mainstream rubber strip sizes on the market. Feature①: The roller is made of high-hardness plastic, which is strong and durable while avoiding the risk of traditional metal rollers scratching the screen mesh. Feature②: Metal bearing design - smoother rotation, even pressure without deviation. TIPS: you can use the provided Allen wrench to quickly disassemble and replace them.
  • 🏡【𝐁𝐥𝐚𝐝𝐞 𝐅𝐮𝐧𝐜𝐭𝐢𝐨𝐧-𝐑𝐞𝐭𝐫𝐚𝐜𝐭𝐚𝐛𝐥𝐞&𝐒𝐭𝐨𝐫𝐚𝐠𝐞&𝐑𝐞𝐩𝐥𝐚𝐜𝐞𝐚𝐛𝐥𝐞】①Retractable-When in use, just hold button, blade will slow rollout, convenient trimming and cutting. Blade can be retracted to prevent Accident scratches. ②Blade has double locking device: it automatically locks to prevent retraction during work and is completely closed to prevent accidental touch when retracted. Ansure your safety. ③Replaceable - A separate button is provided for changing the blades. ④Blade is made of steel-sharp, durable and won't rust. ⑤Storage-Handle has built-in blade storage design to place complimentary blade.Extra equipped 2xreplacement blades- increase service life of tool.
  • 🏡【𝐇𝐢𝐝𝐞𝐚𝐛𝐥𝐞 𝐑𝐞𝐦𝐨𝐯𝐚𝐥 𝐇𝐨𝐨𝐤】The hooks are sharp and can hook out the aged spline. The removal hook can be stored and hidden in the handle slot box. OPEN the box cover, take out the hook and insert it into the groove for use. can RETRACT after use to prevent the hook tip from scratching clothes or tool boxes. Hook made of Stainless steel material won't rust.

Local HTML and local files

If the input is an HTML file that references local stylesheets, fonts, or images, those files must be accessible to the renderer. The CLI documentation says local-file access is restricted unless allowed. Enable access only when necessary, and avoid broadly allowing local-file access for untrusted HTML. Consult the installed build’s help and the documented local-file controls for the exact option syntax.

Check access, authentication and page completeness

The renderer must be able to reach the URL from the machine running the command. A page available in your own browser may not be available from a server because of network restrictions, access controls, or login requirements. The official CLI documentation describes URL and file inputs and loading controls, but the reviewed sources do not establish a WordPress-specific authentication recipe. Do not place passwords or other credentials in a command that may be saved in shell history, logs, or scripts.

After capture, open the image at full size and check for:

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

Compatibility limits to consider

wkhtmltoimage uses Qt WebKit, so its output should not be assumed to match current desktop or mobile browsers, particularly on themes relying on modern CSS. An archived issue opened in 2021 reports that display: flex did not affect output in a wkhtmltoimage 0.12.6 environment. That is a version-specific user report, not a universal compatibility test or a guaranteed workaround. Treat it as a reason to test your actual theme and page rather than as a complete browser-support matrix. See the upstream issue tracker.

If visual fidelity to a modern browser is essential, compare the rendered image against that browser and evaluate whether an older Qt WebKit renderer is appropriate for your page. The reviewed sources provide no current head-to-head benchmark against browser automation tools, so no general speed or fidelity ranking is established here.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshooting common capture problems

The command is not found

The binary may not be installed or may not be on the current shell’s executable path. Confirm the installation location and run the binary by its full path, or correct the path configuration for the environment running the job.

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.

The URL cannot be opened

Check that the URL is reachable from the capture machine, including any network access controls. Verify the URL is correct and that the page does not require a login or other access the command has not been given.

The image is blank or content is missing

Check the output at full size, then verify that linked resources are reachable and scripts have enough time to render the page. Test a longer --javascript-delay for pages with delayed content; waiting is not a guarantee of completion.

Best Value
Hasron Window Screen Removal Tool - 9-Inch, Scratch-Free, Dual-End, Orange
  • WINDOW SCREEN REMOVAL TOOL: Designed to easily engage, lift, and remove window screens without damaging frames or mesh.
  • Durable Nylon Construction – Made from high-strength, impact-resistant nylon that's tough enough to handle repeated use yet gentle on delicate surfaces, won't rust or corrode like metal tools.
  • DUAL-END DESIGN: Features a forked end to engage and lift screen edges and a flat pry tip on the opposite end for versatile use.
  • HIGH-VISIBILITY COLOR: Bright orange construction makes this tool easy to spot and prevents it from being misplaced on the job site.
  • DIY-FRIENDLY: The ideal tool for homeowners and professionals tackling window screen repair, replacement, or seasonal removal tasks.

The layout differs from a current browser

Test the same URL at the intended width and compare the result with a current browser. Qt WebKit may not reproduce modern CSS behavior; the 2021 report about flex layout in a 0.12.6 environment is illustrative, not a universal diagnosis. If the theme depends on features that render incorrectly, this tool may not suit that capture.

Local images or stylesheets do not load

Confirm the paths are valid from the HTML file’s location and that the installed tool’s local-file access rules permit the required resources. Do not enable broad local-file access for untrusted input.

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

A JavaScript option appears ineffective

Check the installed binary’s version and help output, then test a capture with a longer delay. The release history documents a fix in 0.12.2.1 for a historical option-handling issue, but behavior still depends on the actual build and page.

Or skip the browser setup

If you would rather send a URL to an API than install and maintain a local renderer, ScreenshotNeo is a website screenshot API and MCP server. One GET request can return a PNG, JPEG, WebP, or PDF. Its clean-shot steps accept cookie or consent banners and remove more than 60 known consent platforms, newsletter popups, and chat widgets; each step can be turned off. Bot checks and CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and responses include X-Page-Verdict and X-Billed headers.

Example cURL request (replace the URL and API key):

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 setup and parameters. ScreenshotNeo also provides an MCP server with take_screenshot, get_page_info, and capture_pdf tools for AI agents and MCP clients. Its Free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000 shots. Sign up for the free plan.

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

Frequently Asked Questions

Does wkhtmltoimage run inside WordPress?

No. It is a separate command-line renderer that loads a WordPress page by URL or HTML input.

Does the sample command guarantee a full-page image?

No. The width is an example, and you should inspect the output to verify the content and layout you need.

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
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver 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.