Automatic optimization of PDFs

PDF files processed by pdfToolbox are automatically optimized when changes have been applied (e.g. via a Fixup or an Action) and file is saved. These optimizations are only applied when the PDF is saved - so this is not the case when an analysis-only processing is performed.
Even a normal re-save of a PDF will trigger the optimization.

All variants (Standalone, Server/CLI and SDK) of pdfToolbox are doing the following optimizations by default:

  • Remove unreferenced objects
  • Optimize content stream (generating substreams that can be shared)
  • Merge identical forms and images (determined by an MD5 hash of their contents)

It is also possible to:

  • Merge identical fonts and encodings
    and linearize the PDF for optimized web display
  • Disable the optimization completely

Adjust optimization in pdfToolbox Desktop

The way a PDF is going to be optimized in Standalone can be adjusted in the preferences:

Adjust optimization in pdfToolbox Server/CLI

  • The additional merge of identical font descriptors and encodings can be requested by the additional option --optimizepdf within a CLI command (as long as this command creates an output PDF, e.g. when running Profiles).
  • Disable the optimization completely can be requested by the additional option --nooptimization within a CLI command (as long as this command creates an output PDF).

When using the hotfolder processing in Server, these options have to be set a an additional CLI parameters within each job.

For obvious reasons, the 2 options can not be combined.

The previously available action --optimizepdf has been deprecated, but can easily be substituted by:
--topdf --optimizepdf
as --optimizepdf has become a general file processing option on CLI.

Optimization in pdfToolbox 11 and older versions

In pdfToolbox 11 and previous versions, the automatic optimization also optimizes the font structure by default.

Don't see what you're looking for? Contact us & we'll get back as soon as possible.