The Tool Desk
Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →If wkhtmltoimage produces an image whose text is much smaller than the same page in a browser, first reproduce the capture at the exact render width and inspect the page’s computed CSS and JavaScript—not just the image command. Narrow widths can activate responsive rules such as FlowType, which may deliberately calculate a smaller font. Correct the page’s responsive setting or use a representative width; then use zoom or a minimum-font-size floor only when those controls match your goal.
Why wkhtmltoimage can make text look tiny
wkhtmltoimage renders a page with a viewport, rather than copying the appearance of your normal desktop browser window. The viewport width can change media queries, flex and grid wrapping, and JavaScript that calculates typography. A command such as wkhtmltoimage --width 300 --height 100 Test.html Test.png gives the page a very narrow screen to respond to. If the page’s CSS or JavaScript chooses a smaller font at that width, the output is behaving according to the page rules even though it may not match your desktop preview.
A documented example using wkhtmltoimage 0.12.5 on macOS used FlowType for responsive typography. At a 300-pixel render width, FlowType calculated very small text. The accepted fix was to change FlowType’s fontRatio for that layout (the example changed 30 to 15, making text larger) or render at a wider, more representative width. That value is specific to FlowType and that design; it is not a universal wkhtmltoimage setting.
Diagnose the page at the same width
- Record the complete command. Keep the URL or HTML file,
--width,--height, output format, binary version, operating system, installed fonts, and every option. Runwkhtmltoimage --versionand save the result. - Open the page at the capture width. Resize a browser window to the requested width, or use its responsive-device tools. Inspect the element and read the computed
font-size, line height, transforms, and any styles applied by media queries. - Check JavaScript after load. Search for FlowType or code using
window.innerWidth, resize handlers, rem calculations, or libraries that rewrite heading and body sizes. Disable that script temporarily; if the image becomes normal, adjust the page rule rather than the renderer. - Compare one variable at a time. Hold the source page and output dimensions constant while changing width, responsive settings, minimum size, or zoom. This makes wrapping and clipping changes visible and prevents a coincidental improvement from hiding the cause.
Fix responsive CSS and JavaScript first
Adjust FlowType
If FlowType is responsible, lower its fontRatio for the target layout, following the library’s configuration syntax. In the reported case, fontRatio: 15 produced larger text than the default value of 30. Test headings, paragraphs, buttons, and narrow columns after changing it; a larger type scale can create overflow or additional lines.
Quick wins for a faster PC:
Clear out junk files and repair common Windows errorsFree Scan →Scan for outdated or missing drivers - takes under a minuteDriver Scan →Repair Windows errors before they cause bigger problemsFix Now →#1 Best Overall
- Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
- Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
- Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
- Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
- 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
Use a capture-specific responsive rule
When the page needs to stay readable in a generated image, add a media-query rule for the capture range, for example:
@media (max-width: 420px) {
.screenshot-copy { font-size: 16px; line-height: 1.4; }
}
Use your real selector and design requirements. Do not blindly apply a global minimum: navigation, labels, and decorative text may need different values. If the image is meant to represent a desktop page, capture it at a desktop-like width instead of pretending it is a mobile layout.
Choose the correct wkhtmltoimage controls
--width and smart width
The CLI’s --width sets the renderer’s screen width and therefore influences responsive layout; it is not a CSS font-size command. The manual describes width as a guide unless smart-width behavior is disabled. To request a strict width, use --disable-smart-width together with the width and then inspect the resulting composition:
wkhtmltoimage --width 1200 --disable-smart-width https://example.com shot.png
A wider width may select larger responsive typography, but it can also change line wrapping, columns, and lazy-loaded content. Select the width that represents the image’s intended use, not simply the largest number that makes text readable.
Rank #2
- 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
- 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
- Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
- 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
- What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.
--zoom
--zoom scales rendered page content. It is useful when the layout is otherwise correct and you need a uniformly larger or smaller image rendering:
wkhtmltoimage --width 800 --zoom 1.25 input.html output.png
Zoom affects everything—text, images, spacing, and positioned elements. Check for clipping, changed pagination-like composition, and raster output dimensions. The library setting load.zoomFactor is the corresponding object-level option in wrappers; confirm that your wrapper passes it to the binary you actually run.
--minimum-font-size
Use a minimum only when a lower bound is the desired behavior:
wkhtmltoimage --width 800 --minimum-font-size 14 input.html output.png
This imposes a floor; it does not explain why CSS or JavaScript computed a small value. It can cause wrapping, overflow, or overlap, so inspect all text and controls after applying it. The programmatic image setting is web.minimumFontSize.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Rank #3
- Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
- Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
- Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
- Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
- What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
Options that do not solve this image problem
Do not copy PDF advice about intelligent shrinking into an image troubleshooting checklist. The official settings reference says web.enableIntelligentShrinking “Has no effect for wkhtmltoimage.” A --disable-smart-shrinking suggestion may appear in discussions, but it is not documented as an image-rendering fix. Smart-width and intelligent shrinking are separate concepts: use the former only when you need stricter screen-width behavior, and do not expect the latter to enlarge image text.
Recommended diagnostic matrix
| Test | What it changes | What an improvement indicates | Main risk |
|---|---|---|---|
| Browser at the same width | Replicates responsive CSS and script inputs | The page itself is selecting the small size | Browser and wkhtmltoimage engines can still differ |
| Change FlowType or another font rule | Computed CSS size | JavaScript typography is the cause | Overflow and altered hierarchy |
Increase --width |
Viewport and layout breakpoint | Narrow responsive breakpoint caused the issue | Different wrapping or composition |
--zoom |
Overall rendered scale | Layout is correct but uniformly undersized | Everything, including spacing, scales |
--minimum-font-size |
Lower bound for text | Only a few glyph sizes fall below an acceptable floor | Text can collide or reflow |
Reproducible command examples
Local HTML file
wkhtmltoimage --width 300 --height 100 Test.html Test.png
# Compare at a representative width
wkhtmltoimage --width 800 --height 400 Test.html Test-800.png
# Compare a strict width, zoom, and minimum floor
wkhtmltoimage --width 800 --disable-smart-width --zoom 1.15 --minimum-font-size 14 Test.html Test-adjusted.png
Use one change per run while diagnosing. Keep output format and source unchanged, and compare the actual pixel dimensions as well as readability.
When output differs across machines
Compare the exact wkhtmltoimage version and build, operating system, command-line options, input width, installed web fonts, font-loading timing, and source URL or file. A historical wkhtmltopdf project discussion records Linux/Windows differences; one comment attributed some Windows text variation to operating-system DPI. That is older PDF-related discussion, not proof of a universal wkhtmltoimage DPI cause. Treat platform or DPI as an investigation branch only after reproducing the same page and options.
- Install the same binary build where possible.
- Ensure every required font is installed and actually loaded before capture.
- Use a fixed local test page to separate renderer differences from network timing.
- Check whether a wrapper silently changes width, zoom, user agent, or smart-width options.
Troubleshooting common symptoms
Only mobile-width captures are tiny
Inspect media queries and JavaScript at that width. Increase the width or add a targeted responsive rule; do not start with a global zoom if the mobile layout itself is intentional.
Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minuteWindows Errors? Fix Them Before They Spread
Repair common Windows errors and clear accumulated junk for a smoother, more stable PC - no reinstall needed.Free scan · no reinstallRank #4
- Dual Converters, Infinite Potential：Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
- Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
- Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
- Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
- Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft
Zoom enlarges text but clips the right edge
Zoom scales the entire composition. Reduce the zoom, increase the viewport width, or fix the page’s width and wrapping rules. Confirm that the output canvas is large enough.
Minimum font size causes overlapping labels
Remove the floor and fix the rule that computed the small size, or increase available width and line height. A floor cannot create space for content.
Changing width does nothing
Check whether a wrapper overrides the command, whether smart-width remains enabled, and whether the page has a fixed layout. Inspect computed styles at both widths rather than assuming the option reached the renderer.
Images or fonts are missing
Wait for the relevant selector or resource to load, use a local deterministic fixture, verify network access and font URLs, and compare the same environment before diagnosing typography.
Best Value
- 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.
Or skip the browser setup
ScreenshotNeo provides a website screenshot API and MCP server. It accepts cookie and consent banners before capture and removes more than 60 known consent platforms, newsletter popups, and chat widgets; each step can be disabled. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and response headers report the page verdict and billing status. Its options include viewport and device presets, full-page lazy-image loading, CSS-selector element capture, dark mode, retina scale, custom CSS and JavaScript, click actions, selector or network-idle waits, request blocking, headers, cookies, authorization, timezone, geolocation, transparent backgrounds, resizing, TTL caching, signed links, asynchronous webhooks, bulk capture, usage reporting, and PDF output.
One GET request is enough:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp
See the ScreenshotNeo documentation for options. The same request in Python:
import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"}, timeout=90)
r.raise_for_status()
open("shot.webp", "wb").write(r.content)
And 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}`);
if (!res.ok) throw new Error(`${res.status} ${res.statusText}`);
const data = Buffer.from(await res.arrayBuffer());
require('fs').writeFileSync('shot.webp', data);
The Free plan includes 1,000 screenshots a month with no card. Paid plans start at $5 for 3,000; every feature is available on every plan. An MCP server lets Claude, Cursor, or another MCP client call take_screenshot, get_page_info, and capture_pdf. Sign up free for ScreenshotNeo.
Frequently Asked Questions
Is a larger --width always the right fix?
No. It changes responsive layout as well as typography. Use the width that matches the image’s intended composition, then adjust page rules if needed.
Free tools Windows power users keep installed
One-click scans. No signup required.
Should I use --zoom or --minimum-font-size?
Use zoom for an intentional uniform scale change; use minimum-font-size for a lower bound. Neither replaces diagnosing responsive CSS or JavaScript.
Does --disable-smart-shrinking enlarge wkhtmltoimage text?
The official settings reference says intelligent shrinking has no effect for wkhtmltoimage, so it is not a documented image fix.
The Bottom Line
Match the browser viewport to wkhtmltoimage’s width, find the CSS or JavaScript rule that computes the small size, and fix that rule or choose a representative width. Apply zoom or a minimum font size deliberately, and do not rely on PDF smart-shrinking advice for images.
Quick Recap
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.
