Font embedding command line options

If a font is not embedded pdfaPilot CLI will search the system's font direc-­tories in order to find the needed font file, which are:


  • C:\Windows\Fonts


  • /Users/<user>/Library/Fonts
  • /Library/Fonts
  • /System/Library/Fonts


  • /usr/share/fonts
  • /usr/lib/X11/fonts
  • /usr/local/X11R6/lib/X11/fonts
  • /<user home>/.fonts

Additionally the font folder installed together with pdfaPilot CLI will be searched. This folder lies next to the executable in "<callas pdfaPilot CLI directory>\etc\APDFL\Resource\Font".

Define an additional font folder


Additional folder to look up fonts for embedding.



Path to config file


  • Note: You can force pdfaPilot CLI to only scan the folder      defined by --fontfolder (and not search the system's font folders) by      using the option --fontonly.

Substitute fonts


Font substitution can be used when the original fonts used in a PDF file are not available. By default, the font substitution file pdfa.cfg stored in "etc/FontSubstitution/" provides the basis for substitution.

Alternatively, you can also enter a custom path to a fontsubstitution file, e.g.:


If you want to switch off font substitution completely, just hand over an invalid value, e.g.:




Optional, path to config file

The following notations are allowed in the fontsubstitution.cfg:


Each font can be substituted by every other font of the entry.



Only the first font of the entry can be substituted by the following fonts.

SubstituteFirst<tab>font to be substituted<tag>fontname <tab>... 

More examples

Please see Embedding fonts: Font substitution file for further details regarding font and glyph substitution