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

Install wkhtmltoimage through the official wkhtmltopdf Windows package. Download the 64-bit or 32-bit installer (or a 7z archive) that matches your Windows architecture, install or extract it, then verify the executable from Command Prompt or PowerShell. The package is commonly named wkhtmltox or wkhtmltopdf; it includes the separate wkhtmltoimage.exe program.

The stable 0.12.6 release was published on June 11, 2020. The project’s Windows labels say “Vista or later” for installers and “XP/2003 or later” for 7z archives, but those labels are not a guarantee of behavior on every current Windows build. Check the project’s official downloads page and its linked GitHub release before installing.

What you need before installing

  • A supported Windows computer and permission to install software, unless you use the portable 7z archive.
  • Your Windows architecture: normally x64 on modern PCs, or x86 (32-bit) on older systems.
  • A destination folder for the executable if you choose the archive.
  • A test URL or local HTML file that you are authorized to render.

To check architecture, open Settings → System → About and read System type. You can also run msinfo32 and inspect System Type. Select an x64 package for a 64-bit operating system; select x86 for a 32-bit operating system.

Choose the Windows package

Package Architecture choices Project compatibility label Best for
Installer 64-bit or 32-bit Vista or later A conventional setup with Start-menu and uninstaller entries
7z archive 64-bit or 32-bit XP/2003 or later Portable or manual extraction without running an installer

The official downloads page hosts links through GitHub releases. Prefer the installer when you want the simplest setup. Choose the archive when you need a self-contained directory, cannot run installers, or want to control exactly where the files live. The published materials do not establish a performance difference between these package forms.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Sale
LAPGEAR Home Office Pro Lap Desk - Black Carbon, Fits 15.6” Laptops
  • Spacious Design: Measuring 21.1" wide and 14.1" deep, our lap desk comfortably fits most laptops up to 15.6". Extra room for accessories ensures convenience.
  • Enhanced Functionality: Packed with handy features, including a 5x9" precision tracking mouse pad and a built-in phone slot for seamless work or video calls. Plus, enjoy ergonomic support with the integrated cushioned wrist rest.
  • Cool Comfort: Enjoy a stable surface with our lap desk's dual bolster cushion, designed for comfort and airflow, keeping your lap cool during extended use.
  • Durable Surface: Work with confidence on our lap desk's solid surface, featuring a sleek black carbon color, ensuring optimal air circulation to prevent your laptop from overheating.
  • On-the-Go Convenience: With an integrated handle and lightweight design (2.8 lbs), our lap desk is portable for travel or moving around the house, offering flexibility in any space.

Install with the Windows installer

  1. Open the official wkhtmltopdf downloads page and follow its GitHub release link.
  2. Download the Windows installer whose bitness matches your system. The filename may contain wkhtmltox or wkhtmltopdf; that is expected.
  3. Run the downloaded installer. If Windows SmartScreen appears, verify that the file came from the project’s official release link before choosing to continue.
  4. Accept the license, keep the default destination unless your organization requires another folder, and complete the wizard.
  5. Close any existing Command Prompt or PowerShell windows. A newly opened shell is required after a PATH change.

The installer contains both command-line tools. Look in its installation directory for wkhtmltoimage.exe and wkhtmltopdf.exe.

Install from the 7z archive

  1. Download the 64-bit or 32-bit Windows 7z package from the official downloads page.
  2. Extract it with a 7z-compatible utility into a stable folder, for example C:Toolswkhtmltox. Avoid extracting into a temporary Downloads subfolder that may later be cleaned.
  3. Open the extracted folders and locate the directory containing wkhtmltoimage.exe. Depending on the release layout, it may be below a bin directory.
  4. Test the executable by running it from that directory before changing PATH.

Extraction alone does not register a command globally. You must either use the executable’s full path or add its containing folder to PATH.

Verify that wkhtmltoimage works

Run it from its installation folder

In File Explorer, open the folder containing wkhtmltoimage.exe, click the address bar, type cmd, and press Enter. Then run:

wkhtmltoimage https://example.com output.jpg

This should create output.jpg in the current directory. The same syntax works with a local HTML file:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
wkhtmltoimage C:pathtopage.html C:pathtopage.png

Use a file:/// URL if a path contains spaces or if you prefer explicit URL syntax:

Rank #2
Anker USB C Hub, 5-in-1 USBC to HDMI Splitter with 4K Display
  • 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
  • Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
  • Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
  • HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
  • What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
wkhtmltoimage file:///C:/Projects/site/index.html C:UsersyouDesktopsite.png

Check the reported version

wkhtmltoimage --version

Confirm that the command identifies the installed 0.12.x build. If Windows reports that the command is unknown, the program may still be installed; the shell simply cannot locate its directory yet.

Add wkhtmltoimage to PATH

PATH lets you run wkhtmltoimage from any directory. Add the folder that directly contains wkhtmltoimage.exe, not the parent folder several levels above it.

  1. Press Windows, search for environment variables, and select Edit the system environment variables.
  2. In System Properties, select Environment Variables.
  3. Under User variables (usually sufficient), select Path and choose Edit.
  4. Choose New, paste the executable directory, and confirm with OK through every dialog.
  5. Open a new Command Prompt or PowerShell window and run wkhtmltoimage --version.

For a temporary, current-session test in Command Prompt, use:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
set "PATH=C:Toolswkhtmltoxbin;%PATH%"
wkhtmltoimage --version

In PowerShell, use:

$env:Path = "C:Toolswkhtmltoxbin;$env:Path"
wkhtmltoimage --version

These session commands disappear when the shell closes; use the Environment Variables dialog for a permanent user PATH entry.

Useful capture commands

Full-page image

wkhtmltoimage --format png --quality 95 --width 1440 https://example.com example-full.png

Options vary by build, so run wkhtmltoimage --help on your installation and confirm the flags your workflow needs. Common controls include output format, image quality, viewport width, javascript delay, custom headers, cookies, and disabling JavaScript.

Rank #3
Sale
Yilador Webcam Cover 3 Pack, 0.03 inch Ultra Thin Laptop Camera Cover Slide
  • Note: Not suitable for MacBooks released after 2023 or devices with a protruding front camera; Not applicable to full-screen or notch-style tempered glass screen protectors; Do not use on the rear camera of the phone.
  • 💻 Why Do You Need a Webcam Cover Slide? — Safeguard your privacy by covering your webcam with our reliable webcam cover when not in use. Don't let anyone secretly watch you. Stay protected!
  • ✅ Thin & Stylish — Enhance your laptop's functionality and aesthetics with our 0.027" ultra-thin webcam covers. Seamlessly close your laptop while adding a touch of sophistication.
  • ✅ Fits Most Devices — Compatible with laptops, phones, tablets, desktops! Keep your privacy intact on Ap/ple, Mac/Book, iPh/one, iP/ad, H/P, L/novo, De/ll, Ac/er, As/us, Sa/msung devices.
  • ✅ 365 Days Protection — Our upgraded 3.0 adhesive ensures a strong hold that won't damage your equipment. Experience reliable, long-term privacy protection day in and day out.

Wait for client-rendered content

wkhtmltoimage --javascript-delay 3000 https://example.com rendered.png

A delay gives scripts time to modify the page, but it also increases runtime. If the page never finishes or depends on browser APIs unsupported by the embedded Qt WebKit engine, a delay will not make it compatible.

Capture a local file with spaces in its path

wkhtmltoimage "C:ProjectsMarketing Pageshome.html" "C:Outputhome.png"

Always quote Windows paths containing spaces. Ensure the output directory already exists; the command does not reliably create missing parent directories.

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

Why “wkhtmltoimage is not recognized” appears

The executable is not on PATH

Run the command from the installation directory or invoke the full path:

"C:Program Fileswkhtmltopdfbinwkhtmltoimage.exe" https://example.com output.png

If that works, add the quoted path’s directory to your user PATH and open a new shell.

You changed PATH but reused an old shell

Command Prompt and PowerShell read environment variables when they start. Close all old windows and open a fresh one. In an existing PowerShell session, inspect the current value with $env:Path.

Rank #4
AboveTEK Portable Laptop Lap Desk w/Retractable Left/Right Mouse Pad Tray, Non-Slip Heat Shield Tablet Notebook Computer Stand Table w/Sturdy Stable Work Surface for Bed Sofa Couch or Travel
  • Anti-Slip Surface - Transform your laptop into a mobile workstation with the AboveTEK portable laptop lap desk. The anti-slip surface provides a strong grip for laptops up to 15.6 inches(Diagonal), while the double rubber strip on the bottom ensures a stable display or typing experience on your lap, couch, or bed.
  • Retractable Mouse Pad - Retractable laptop mouse pad extends on both directions for the left/right handed with elevation along the edges for stopping mouse from falling off. The size of laptop tray is 14" X 9.7" and the size of mouse pad is 7.4" X 6.1".
  • Effective Heat Shield - The effective heat shield made of sturdy and thick material protects your laptop from overheating. Prioritizes your comfort and safety, an ideal lap pad or board for working anywhere.
  • EASY to Carry and Store - With an ergonomic and simplistic design, the lap desk is portable to store in a backpack. Only 15" in size, 2.2 lb of weight and with slim 0.6 inch thickness, it is ready to be easily carried around.
  • Widely Applicable - The smooth platform accommodates laptops and tablets up to 15.6 inches(Diagonal), making it a versatile accessory and one of the best gifts for mom, dad, students and professionals. Perfect for use as a laptop bed tray or tablet holder anywhere at home, library, or park.

You added the wrong directory

Use File Explorer search for wkhtmltoimage.exe, then add the exact containing folder. Do not add the path to the installer file, archive, or a shortcut.

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.

32-bit and 64-bit packages were mixed up

Remove the mismatched package and install the architecture appropriate for Windows. A 32-bit application can often run on 64-bit Windows, but the project publishes separate packages and matching them avoids loader surprises.

PowerShell treats a full path unexpectedly

When calling a quoted executable path in PowerShell, place the call operator before it:

& "C:Program Fileswkhtmltopdfbinwkhtmltoimage.exe" https://example.com output.png

Common capture failures and fixes

Symptom Likely cause What to try
Blank or partly rendered image JavaScript content has not loaded, or the page uses browser features unsupported by the old Qt WebKit engine. Try --javascript-delay, verify the URL in a browser, and simplify or prerender the page.
Images or fonts missing Network access, mixed-content rules, relative paths, or blocked resources. Use absolute HTTPS asset URLs, verify the file can be reached from the machine, and test a local asset path.
Access denied writing output The destination is protected or the file is open by another program. Write to a user-writable directory, close the image viewer, and choose a new filename.
Command works only in one folder PATH is absent or points to a different installation. Use where wkhtmltoimage, correct PATH, and start a new shell.
URL fails while local HTML works Proxy, DNS, TLS, authentication, or site bot protection. Test connectivity from the same machine and supply supported headers or cookies where appropriate.
Installer will not run Windows policy, SmartScreen, damaged download, or insufficient permissions. Re-download from the official release link, verify architecture, and ask an administrator about local policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Automation, reliability, and security

wkhtmltoimage is a headless command-line renderer based on Qt WebKit. Its 0.12.6 release dates to 2020, so modern JavaScript, CSS, TLS behavior, and anti-bot systems may not match a current full browser. Pin the exact executable path in scheduled jobs, log the command and exit code, set an external timeout, and write outputs to unique filenames.

Do not treat arbitrary HTML as harmless input. The project warns: “Do not use wkhtmltopdf with any untrusted HTML – be sure to sanitize any user-supplied HTML/JS, otherwise it can lead to complete takeover of the server it is running on!” Sanitize user-controlled markup, isolate rendering in a low-privilege process, restrict outbound network access where possible, and never pass unsanitized HTML or JavaScript from an untrusted user directly to an automated renderer.

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.
Best Value
Sale
LAPGEAR Home Office Lap Desk – Pink, Fits 15.6” Laptops
  • Spacious Design: Measuring 21.1" wide and 12" deep, our lap desk comfortably fits most laptops up to 15.6". Extra room for accessories ensures convenience.
  • Enhanced Functionality: Packed with handy features, including a 5x9" precision tracking mouse pad and a built-in phone slot for seamless work or video calls. Plus, enjoy laptop support with the integrated device ledge.
  • Cool Comfort: Enjoy a stable surface with our lap desk's dual bolster cushion, designed for comfort and airflow, keeping your lap cool during extended use.
  • Durable Surface: Work with confidence on our lap desk's solid surface, featuring a blush pink color, ensuring optimal air circulation to prevent your laptop from overheating.
  • On-the-Go Convenience: With an integrated handle and lightweight design (2.14 lbs), our lap desk is portable for travel or moving around the house, offering flexibility in any space.

Because the published stable release is old and the repository is archived, evaluate whether your compliance, browser-compatibility, and security requirements are met before deploying it as a service. A successful local installation proves only that the binary launches; it does not prove that every site will render correctly.

Or skip the browser setup

If your goal is simply to obtain a clean website screenshot, ScreenshotNeo provides a hosted API and MCP server instead of requiring a Windows renderer installation. One GET request returns PNG, JPEG, WebP, or PDF. Before capture it accepts cookie/consent banners and removes more than 60 known consent platforms, newsletter popups, and chat widgets; each cleanup step can be disabled. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and response headers identify the page verdict and billing status.

Read the parameter details in the ScreenshotNeo documentation. A minimal Windows-compatible cURL call is:

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

Python:

import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"}, timeout=90)
open("shot.webp", "wb").write(r.content)

Node.js:

const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);

ScreenshotNeo also offers an MCP server with take_screenshot, get_page_info, and capture_pdf tools for Claude, Cursor, and other MCP clients. Every feature is included on every plan; the Free plan includes 1,000 screenshots per month without a card, and paid plans start at $5 for 3,000 shots. Create a free ScreenshotNeo account to try it.

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

Frequently asked questions

Is wkhtmltoimage a separate download?

No. It is included in the wkhtmltopdf command-line package, even when the installer’s filename uses wkhtmltox or wkhtmltopdf.

Can I install it without administrator rights?

The 7z archive can usually be extracted into a directory you can write to. You still need permission to modify a system PATH; use a user PATH entry or the full executable path instead.

Does installing wkhtmltoimage install a web browser?

No. It installs command-line rendering binaries based on Qt WebKit rather than a general-purpose interactive browser.

Where should I report an incompatibility?

First record the exact 0.12.x version, package architecture, command, URL type, and error output. Then consult the project’s official release and documentation channels; compatibility with an individual modern site is not guaranteed by the Windows package label.

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

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.