BASALT · JOURNAL
When a PDF prints blank or wrong
A page that displays correctly and prints blank is almost always one of three things.
Form fields with no appearance streams
The most common cause. A form field has a value and a separate visual representation called an appearance stream. If the value was set without regenerating the appearance, some viewers draw it from the value and printers draw the appearance, which is empty.
The fix is to flatten the form, which converts field values into ordinary page content. After flattening the values are part of the page and print everywhere.
Flatten anything you are filing or sending onward regardless, because an unflattened form is also editable by whoever receives it.
Annotations set not to print
Annotations carry a print flag. A comment, stamp or drawn shape can be visible on screen and marked not to print, which is sometimes deliberate and often accidental.
Flattening resolves this too, by merging annotation content into the page.
Transparency and blend modes
Less common, and specific to older printers and some PostScript workflows. Content using transparency groups can render on screen and drop out when flattened to PostScript by the print pipeline.
The workaround is to print as image from the print dialogue's PDF options, which rasterises the page and prints what you see.
Diagnosing quickly
Export to a new PDF and open that. If the export is blank, the problem is in the document and flattening will likely fix it. If the export looks right and only printing fails, the problem is in the print pipeline, and print as image is the workaround.
Before sending a filled form
Fill, flatten, then check by extracting text from the output. If the values you typed do not appear in the extraction, they are not really in the page, and the recipient may receive an empty form.
Frequently asked questions
Why does my PDF print blank?
Most often because form field values were set without regenerating their appearance streams, so the data exists but nothing draws it. Flattening the form converts values into page content and fixes it.
What does flattening a PDF do?
It converts form field values and annotation content into ordinary page content. After flattening the material renders identically everywhere and cannot be edited or cleared by a recipient.
Why do annotations not print?
Annotations carry a print flag that can be set off, sometimes deliberately and often by accident. Flattening merges their content into the page so it prints.
How do I check a filled form will print correctly?
Flatten it, then extract the text from the output and confirm the values you typed appear. If they do not, they are not part of the page and the recipient may receive a blank form.
Doing it in Basalt
Basalt is a native macOS PDF toolkit: eighteen tools in one window covering merge, split, page organisation, compression, OCR, passwords, Bates numbering, forms, signing, watermarks and comparison. Every file is processed on your Mac, and the engine that opens documents holds no network entitlement at all, which macOS enforces at the code-signature level. Redaction destroys content rather than covering it, and an independent verifier proves the material is gone before a file is written. A one time $29 licence covers up to three Macs, free for the first 24 hours. Get it at basaltformac.com, or brew install --cask chipmunk1101/tap/basalt.
Redaction that proves itself
Basalt destroys the content you mark, then re-opens the file it wrote and proves the content is gone before it saves anything. Your documents never leave your Mac.