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 minutePC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11If page-break-after appears to do nothing in wkhtmltopdf, inspect the element’s containing layout before changing the rule itself. A floated ancestor is a documented cause in issue reports: removing the parent float fixed one reproduction, and another report used PDF-only float: none rules. Then test ancestor overflow, isolate table-row pagination, and reproduce the result with the exact wkhtmltopdf build and a minimal document.
What “ignored” means in wkhtmltopdf
There are two different symptoms:
- The expected break never appears, so the next content continues on the same page.
- The break works, but
page-break-after: alwaysleaves an unwanted blank page at the end because there is no content after the element.
These reports come from particular wkhtmltopdf and WebKit builds. They show real failure modes, not a guarantee that every current package behaves identically. Always verify the PDF produced by the version you deploy.
Fix it in the order most likely to explain the symptom
- Record the wkhtmltopdf version and operating-system version.
- Reduce the document to the content around the break and its ancestor styles.
- Inspect every containing element for
float. - If that does not explain the result, inspect ancestor
overflow. - If the break is inside a table, test table pagination separately.
- Check whether the apparent failure is actually an unwanted trailing page.
- Render the minimal case with the exact deployed binary and inspect the PDF.
1. Record the exact renderer
Run:
wkhtmltopdf --versionSave the complete output, operating-system and version, command-line switches, HTML, CSS and any JavaScript used. The project’s support guidance asks for these details and a reproducible HTML/CSS/JavaScript test case. A distribution package, patched-Qt build and another 0.12-era build can produce different results.
2. Build a minimal reproduction
Remove unrelated scripts, fonts, images and layout components. Keep the break element, its following content and each ancestor’s layout declarations. This tells you whether the failure belongs to the document structure or to a broader page.
Do these 3 things before closing this tab:
1Repair Windows errors before they cause bigger problems2Fix the driver behind crashes, sound loss and screen glitches3Clear out junk files and repair common Windows errors#1 Best Overall
- INNOVATIVE CARTRIDGE-FREE PRINTING — No more dealing with lots of tiny ink cartridges; With this wireless document and photo printer each ink bottle set is equivalent to about 90 individual cartridges²
- LESS FREQUENT INK REPLACEMENT — Replacement ink bottles don't have to be changed nearly as often as ink cartridges¹; When you choose this combination printer, scanner and copier you can print up to 4,500 pages black/7,500 color³
- COLOR PRINTING — Up to 2 years of ink in the box4 (and with every replacement ink set) for fewer out-of-ink frustrations
- ZERO CARTRIDGE WASTE — By using an Epson EcoTank printer you can help reduce the amount of cartridge waste ending up in landfills
- HOME PRINTER DESIGNED FOR RELIABILITY — The Epson EcoTank ET-2800 All-in-One Supertank Color Printer creates vivid, detailed prints and documents thanks to Micro Piezo Heat-Free Technology; Fire off 10 ISO pages per minute1 to easily finish large jobs
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<style>
@media print {
.section {
page-break-after: always;
}
}
</style>
</head>
<body>
<section class="section">
<h1>First section</h1>
<p>Content before the requested break.</p>
</section>
<section>
<h1>Second section</h1>
<p>Content that should start after the break.</p>
</section>
</body>
</html>Render it with the same command and binary used in production:
wkhtmltopdf input.html output.pdfThen add your real ancestors and styles one at a time. The first change that reproduces the failure is more useful than a large page that fails in several ways at once.
Check floated ancestors first
In wkhtmltopdf issue #1604, the reporter wrote that removing float: left; from the parent fixed the page-break example. Issue #2371 describes a similar case in which the workaround was PDF-specific CSS applying float: none to parent elements where breaks were needed.
The important detail is that the float may be on an ancestor, not on the element carrying page-break-after. Inspect the complete containing chain in your HTML. A typical screen layout might look like this:
The Tool Desk
Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →.column {
float: left;
}
.column .chapter-end {
page-break-after: always;
}Try a narrowly scoped print override on the actual containing element:
Rank #2
- CARTRIDGE-FREE PRINTING — Print lab-quality photos, graphics and creative projects; Get vibrant colors and sharp text with Epson's high-accuracy printhead and Claria ET Premium 6-color inks
- INK BOTTLES — Save on photos1 and creative projects with affordable in-house printing; All-in-one printer allows you to print 4" x 6" photos for about 4 cents each vs. 40 cents with traditional ink cartridges1
- LESS FREQUENT INK REPLACEMENT — Replacement ink bottles don't have to be changed nearly as often as ink cartridges¹; Printer, scanner and copier lets you print up to 6,200 color pages³
- PRINT FOR LONGER — Up to 2 years of ink in the box² (and with every replacement ink set) for fewer out-of-ink frustrations with this wireless printer
- ZERO CARTRIDGE WASTE — Epson EcoTank printer helps reduce the amount of cartridge waste ending up in landfills; Cartridge-free printer uses high-yield ink bottles; Each replacement ink bottle set is equivalent to about 100 individual ink cartridges⁴
@media print {
.pdf-page-break-container {
float: none;
}
}Replace .pdf-page-break-container with your selector. Do not remove every float globally until you know it is responsible; that can destroy a two-column screen layout and create a different PDF problem. The issue reports support this as a case-specific experiment, not as a universal fix.
Inspect ancestor overflow next
An issue-thread comment links overflow: auto on an ancestor with page-break problems and suggests testing overflow: visible. This is user-reported diagnostic evidence, so reproduce it in your own minimal case before adopting it.
@media print {
.report-wrapper {
overflow: visible;
}
}Apply the override only to the wrapper that clips or scrolls the content. Check for overflow: auto, hidden or other non-visible values on every ancestor between the break element and the document root. If changing overflow has no effect in the minimal file, revert the override and continue investigating.
When the break is inside a table
Table pagination is a separate failure mode. A report involving large table rows describes before/after breaks being ignored even though the author did not observe floats or overflow. A row that is taller than the remaining page, or that must be fragmented across pages, should therefore be isolated from the float investigation.
Make a table-only test
<!doctype html>
<html>
<head>
<style>
table { width: 100%; border-collapse: collapse; }
td { border: 1px solid #999; padding: 8px; }
.break-after { page-break-after: always; }
</style>
</head>
<body>
<table>
<tr><td>Short row</td></tr>
<tr class="break-after">
<td>Replace this with the large row that fails.</td>
</tr>
<tr><td>Following row</td></tr>
</table>
</body>
</html>Render the table alone, then test the same content outside a table. If the break works outside the table but not for the row, treat it as table pagination rather than proof that the float workaround is wrong. The cited 0.12.3 development-build report specifically remained unresolved after the reporter ruled out floats and overflow.
Rank #3
- SET IT UP ONCE AND PRINT WITH CONFIDENCE. No complicated maintenance. Just easy, reliable printing you can count on.
- INK FOR YEARS. NOT MONTHS. Up to 2 years of ink included. Get thousands of pages of cartridge-free printing. More pages, less hassle
- KEEPS PRINTING WELL AFTER COMPETITORS HAVE QUIT. No complex maintenance. Sharper text, richer colors.[2] Only with HP Smart Tank
- PREMIUM SUPPORT - Strong technical expertise to solve issues faster
- THE LAST PRINTER YOU'LL EVER NEED. Enjoy years of refillable, cartridge-free printing.
Check for the unwanted trailing-page variant
In a 0.12-era issue discussion, a maintainer attributed an extra final page to an updated WebKit engine respecting page-break-after: always even when no content followed the element. If your PDF has the expected internal break plus one empty page at the end, the rule may be working.
Confirm that the final element does not carry an unconditional break. Apply the rule only where another section follows, or use a class that marks non-final sections. Test this change with the exact binary and document that produced the blank page; the report is version-specific.
Use print-only CSS without damaging the screen layout
Keep PDF workarounds inside @media print whenever possible. This lets the browser layout retain its floats and scrolling behavior while the PDF layout receives the targeted changes.
@media print {
.pdf-page-break-container { float: none; }
.pdf-scroll-region { overflow: visible; }
.section:not(:last-child) { page-break-after: always; }
}Use your real selectors and verify the result visually. A selector that matches the wrong ancestor can make the break appear fixed while introducing overlapping or reordered content elsewhere.
Troubleshooting matrix
| Symptom | Test | Likely interpretation | Next action |
|---|---|---|---|
| Break ignored in a multi-column layout | Remove the containing float in the minimal file | Float-related case reported in issues #1604 and #2371 | Try a targeted print rule with float: none |
| No change after the float test | Toggle ancestor overflow: auto or hidden to visible |
Possible overflow interaction reported by an issue commenter | Keep the override only if your reproduction confirms it |
| Break fails only for a large table row | Render the table without the rest of the page | Distinct table-row pagination problem | Do not assume the float workaround applies; document the exact build |
| One extra blank page at the end | Remove the final element’s unconditional break | Possible trailing-page behavior reported in a 0.12-era discussion | Apply the break only when following content exists |
| Different machines produce different PDFs | Compare wkhtmltopdf --version, OS and switches |
Build or WebKit differences | Pin and record the production binary, then retest |
What to include in a useful bug report
Provide the exact wkhtmltopdf version, operating-system and version, command line, a minimal HTML file, its CSS and JavaScript, and the generated PDF or a precise description of the wrong page. State whether the failing element is inside a float, whether any ancestor has non-visible overflow, whether a table row is involved, and whether the result is a missing break or an extra trailing page. This makes the issue reproducible instead of turning it into a general claim about all wkhtmltopdf releases.
Rank #4
- Wireless Bluetooth Printer: Portable thermal printer compatible with iPhone, Android phones, iPad and tablet computers via Bluetooth. For smartphones, please download the "Nada Print" App. You can also connect to laptops and computers for printing using a USB-C cable. (Note: Laptops and computers can only be connected via USB and require the installation of a driver first. Bluetooth connection is not supported.)
- No-ink printing: Only supports US Letter and A4 size thermal paper.(Doesn't support regular paper) The no-ink portable thermal printer uses direct thermal technology, requiring no ink, toner or ribbons, making it environmentally friendly, cost-effective and time-saving. The thermal printer package comes with a roll of US Letter thermal printing paper. Note: When installing the paper, remember to switch the paper size switch on APP
- Clear Print: NDYIN N80 portable thermal printer adopts high-definition printing technology, with a 203DPI resolution to provide you with clear printing results. This mobile printer is compatible with roll paper, folded paper and tattoo transfer paper, supporting printing from your mobile phone PDF, Word, pictures and web pages anytime and anywhere. It is recommended to use our NDYIN thermal paper to achieve good printing quality
- Portable wireless printer for travel: The thermal printer is equipped with a built-in 1500mAh rechargeable battery, which can print 160 sheets of 8.5" x 11" thermal paper after being fully charged. It weighs only 1.5 pounds and is compact in size. This ink-free portable printer can be easily carried in a backpack or briefcase! It is perfect for business travel, cars, small offices, construction sites, schools and homes. You can print documents, contracts, invoices and boarding passes anytime and anywhere
- The N80 thermal printer has a wide range of uses. The package includes the N80 printer, a roll of US Letter paper(7m/roll), a user manual, a guide card, a type-C soft cable and a type C adapter. Note: The charging adapter is not included. Special thermal paper is required for use; ordinary paper cannot be used. This ink-free portable thermal printer is suitable for various scenarios such as home, school, travel, office, and outdoor, meeting the printing needs of different groups of people. This tattoo template printer is also compatible with tattoo transfer paper, making it an ideal choice for tattoo art
When to consider another renderer
If targeted CSS changes do not resolve the minimal case, compare a different HTML-to-PDF renderer against your actual document. Evaluate page-break fidelity, table handling, reproducibility of the version or build, required CSS and JavaScript support, and the migration work. The issue evidence does not establish that one replacement is universally better, so run the same fixture through each candidate and inspect the PDFs.
Or skip the browser setup
If your real requirement is a reliable website capture rather than debugging a local wkhtmltopdf document, ScreenshotNeo provides a screenshot API and MCP server. It accepts consent banners before capture and removes more than 60 known consent platforms, newsletter popups and chat widgets; each step can be disabled. Bot checks, CAPTCHAs, blank pages, timeouts, failed loads and cache hits are not billed, and the response identifies the page verdict and billing status in X-Page-Verdict and X-Billed headers.
One request returns PNG, JPEG, WebP or PDF. The API also supports full-page capture with lazy images, CSS-selector element capture, dark mode, device presets or custom viewports, retina scale, PDF paper and margin settings, custom CSS and JavaScript, clicks, selector or network-idle waits, request blocking, headers, cookies, user agents, authorization, timezone, geolocation, transparent backgrounds, resizing, configurable caching, signed image links, asynchronous jobs with signed webhooks, bulk capture of up to 100 URLs per call, usage reporting and an OpenAPI specification. Existing parameter names used by other screenshot APIs are accepted to ease migration.
cURL (see the ScreenshotNeo documentation):
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpPython:
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}`);An MCP server lets Claude, Cursor and other MCP clients call take_screenshot, get_page_info and capture_pdf. The Free plan includes 1,000 shots each month without a card; paid plans start at $5 for 3,000 shots. Create a free ScreenshotNeo account to try it.
The Bottom Line
Start with the containing layout: remove or print-override ancestor floats, then test ancestor overflow. Isolate table rows, distinguish a missing break from a trailing blank page, and validate every change with a minimal file and the exact wkhtmltopdf build you deploy.
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.
