---
name: "wkhtmltoimage"
section: "1"
platform: "linux"
package: "wkhtmltopdf"
version: "0.12.6-2+b1"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/wkhtmltoimage"
---

# wkhtmltoimage(1)

html to image converter

## Name

wkhtmltoimage - html to image converter

## Synopsis

  wkhtmltoimage \[OPTIONS\]... \<input file\> \<output file\>

## Description

Converts an HTML page into an image,

## General Options

- **--allow** *\<path\>*

  Allow the file or files from the specified folder to be loaded (repeatable)

- **--bypass-proxy-for** *\<value\>*

  Bypass proxy for host (repeatable)

- **--cache-dir** *\<path\>*

  Web cache directory

- **--checkbox-checked-svg** *\<path\>*

  Use this SVG file when rendering checked checkboxes

- **--checkbox-svg** *\<path\>*

  Use this SVG file when rendering unchecked checkboxes

- **--cookie** *\<name\>* *\<value\>*

  Set an additional cookie (repeatable), value should be url encoded.

- **--cookie-jar** *\<path\>*

  Read and write cookies from and to the supplied cookie jar file

- **--crop-h** *\<int\>*

  Set height for cropping

- **--crop-w** *\<int\>*

  Set width for cropping

- **--crop-x** *\<int\>*

  Set x coordinate for cropping

- **--crop-y** *\<int\>*

  Set y coordinate for cropping

- **--custom-header** *\<name\>* *\<value\>*

  Set an additional HTTP header (repeatable)

- **--custom-header-propagation**

  Add HTTP headers specified by --custom-header for each resource request.

- **--no-custom-header-propagation**

  Do not add HTTP headers specified by --custom-header for each resource request.

- **--debug-javascript**

  Show javascript debugging output

- **--no-debug-javascript**

  Do not show javascript debugging output

- **--encoding** *\<encoding\>*

  Set the default text encoding, for input

- **-H, --extended-help**

  Display more extensive help, detailing less common command switches

- **-f, --format** *\<format\>*

  Output file format

- **--height** *\<int\>*

  Set screen height (default is calculated from page content)

- **-h, --help**

  Display help

- **--htmldoc**

  Output program html help

- **--images**

  Do load or print images

- **--no-images**

  Do not load or print images

- **-n, --disable-javascript**

  Do not allow web pages to run javascript

- **--enable-javascript**

  Do allow web pages to run javascript

- **--javascript-delay** *\<msec\>*

  Wait some milliseconds for javascript finish

- **--license**

  Output license information and exit

- **--load-error-handling** *\<handler\>*

  Specify how to handle pages that fail to load: abort, ignore or skip

- **--load-media-error-handling** *\<handler\>*

  Specify how to handle media files that fail to load: abort, ignore or skip

- **--disable-local-file-access**

  Do not allowed conversion of a local file to read in other local files, unless explicitly allowed with --allow

- **--enable-local-file-access**

  Allowed conversion of a local file to read in other local files.

- **--log-level** *\<level\>*

  Set log level to: none, error, warn or info

- **--manpage**

  Output program man page

- **--minimum-font-size** *\<int\>*

  Minimum font size

- **--password** *\<password\>*

  HTTP Authentication password

- **--disable-plugins**

  Disable installed plugins

- **--enable-plugins**

  Enable installed plugins (plugins will likely not work)

- **--post** *\<name\>* *\<value\>*

  Add an additional post field (repeatable)

- **--post-file** *\<name\>* *\<path\>*

  Post an additional file (repeatable)

- **-p, --proxy** *\<proxy\>*

  Use a proxy

- **--proxy-hostname-lookup**

  Use the proxy for resolving hostnames

- **--quality** *\<int\>*

  Output image quality (between 0 and 100)

- **-q, --quiet**

  Be less verbose, maintained for backwards compatibility; Same as using --log-level none

- **--radiobutton-checked-svg** *\<path\>*

  Use this SVG file when rendering checked radiobuttons

- **--radiobutton-svg** *\<path\>*

  Use this SVG file when rendering unchecked radiobuttons

- **--readme**

  Output program readme

- **--run-script** *\<js\>*

  Run this additional javascript after the page is done loading (repeatable)

- **--ssl-crt-path** *\<path\>*

  Path to the ssl client cert public key in OpenSSL PEM format, optionally followed by intermediate ca and trusted certs

- **--ssl-key-password** *\<password\>*

  Password to ssl client cert private key

- **--ssl-key-path** *\<path\>*

  Path to ssl client cert private key in OpenSSL PEM format

- **--stop-slow-scripts**

  Stop slow running javascripts

- **--no-stop-slow-scripts**

  Do not Stop slow running javascripts

- **--user-style-sheet** *\<path\>*

  Specify a user style sheet, to load with every page

- **--username** *\<username\>*

  HTTP Authentication username

- **-V, --version**

  Output version information and exit

- **--width** *\<int\>*

  Set screen width, note that this is used only as a guide line. Use --disable-smart-width to make it strict.

- **--window-status** *\<windowStatus\>*

  Wait until window.status is equal to this string before rendering page

- **--zoom** *\<float\>*

  Use this zoom factor

## Contact

If you experience bugs or want to request new features please visit \<https://wkhtmltopdf.org/support.html\>

## Authors

  Jakob Truelsen              \<antialize@gmail.com\>\
   Ashish Kulkarni             \<ashish@kulkarni.dev\>\
   Jan Habermann               \<jan@habermann24.com\>\
   Pablo Ruiz García           \<pablo.ruiz@gmail.com\>\
   Trevor North                \<trevor@blubolt.com\>\
   Nate Pinchot                \<nate.pinchot@gmail.com\>\
   pussbb                      \<pussbb@gmail.com\>\
   Aaron Stone                 \<aaron@serendipity.cx\>\
   Patrick Widauer             @a-ctor\
   Peter van der Tak           \<pta@ibuildgreen.eu\>\
   Benjamin Sinkula            \<bsinky@gmail.com\>\
   Kasper F. Brandt            \<poizan@poizan.dk\>\
   Michael Nitze               \<michael.nitze@online.de\>\
   Rok Dvojmoc                 \<rok.dvojmoc@gmail.com\>\
   theirix                     \<theirix@gmail.com\>\
   Tomsgu                      \<tomasjakll@gmail.com\>\
   Artem Butusov               \<art.sormy@gmail.com\>\
   Christian Sciberras         \<uuf6429@gmail.com\>\
   Daniel M. Lambea            \<dmlambea@gmail.com\>\
   Douglas Bagnall             \<douglas@paradise.net.nz\>\
   peterrehm                   \<peter.rehm@renvest.de\>\
   Renan Gonçalves             \<renan.saddam@gmail.com\>\
   Ruslan Grabovoy             \<kudgo.test@gmail.com\>\
   Sander Kleykens             \<sander.kleykens@avnu.be\>\
   Adam Thorsen                \<adam.thorsen@gmail.com\>\
   Albin Kerouanton            \<albin.kerouanton@knplabs.com\>\
   Alejandro Dubrovsky         \<alito@organicrobot.com\>\
   Arthur Cinader              @acinader\
   Benoit Garret               \<benoit.garret@gmail.com\>\
   Bill Kuker                  \<bkuker@billkuker.com\>\
   cptjazz                     \<alexander@jesner.eu\>\
   daigot                      \<daigot@rayze.com\>\
   Destan Sarpkaya             @destan\
   Duncan Smart                \<duncan.smart@gmail.com\>\
   Emil Lerch                  \<emil@lerch.org\>\
   Erik Hyrkas                 \<erik.hyrkas@thomsonreuters.com\>\
   Erling Linde                \<erlingwl@gmail.com\>\
   Fábio C. Barrionuevo da Luz \<bnafta@gmail.com\>\
   Fr33m1nd                    \<lukion@gmx.de\>\
   Frank Groeneveld            \<frank@frankgroeneveld.nl\>\
   Immanuel Häussermann        \<haeussermann@gmail.com\>\
   Jake Petroules              \<jake.petroules@petroules.com\>\
   James Macdonald             \<james@kingfisher-systems.co.uk\>\
   Jason Smith                 \<JasonParallel@gmail.com\>\
   John Muccigrosso            @Jmuccigr\
   Julien Le Goff              \<julego@gmail.com\>\
   Kay Lukas                   \<kay.lukas@gmail.com\>\
   Kurt Revis                  \<krevis@snoize.com\>\
   laura                       @holamon\
   Marc Laporte                \<marc@laporte.name\>\
   Matthew M. Boedicker        \<matthewm@boedicker.org\>\
   Matthieu Bontemps           \<matthieu.bontemps@gmail.com\>\
   Max Sikstrom                \<max.sikstrom@op5.com\>\
   Nolan Neustaeter            \<github@noolan.ca\>\
   Oleg Kostyuk                \<cub.uanic@gmail.com\>\
   Pankaj Jangid               \<pankaj.jangid@gmail.com\>\
   robinbetts                  \<robinbetts@yahoo.com\>\
   Sem                         \<spam@esemi.ru\>\
   Stefan Weil                 \<sw@weilnetz.de\>\
   Stephen Kennedy             \<sk4425@gmail.com\>\
   Steve Shreeve               \<steve.shreeve@gmail.com\>\
   Sven Nierlein               \<sven@nierlein.org\>\
   Tobin Juday                 \<tobinibot@gmail.com\>\
   Todd Fisher                 \<todd.fisher@gmail.com\>\
   Костадин Дамянов            \<maxmight@gmail.com\>\
   Emmanuel Bouthenot          \<kolter@openics.org\>\
   Rami                        @icnocop\
   Khodeir-hubdoc              @Khodeir-hubdoc\
   Jonathan Jefferies          @jjok\
   Joe Ayers                   \<joseph.ayers@crunchydata.com\>\
   Jeffrey Cafferata           \<jeffrey@jcid.nl\>\
   rainabba\
   Mehdi Abbad\
   Lyes Amazouz\
   Pascal Bach\
   Mário Silva