This is not the latest version of this document; to access the latest version, click here.
Official Content

Sets the library to use for generating web reports in PDF format.


iText (Legacy) Default value. Uses iText 2 or 4 (depending on the Generator) to generate PDF and provides HTML print management in PDF reports.
iText 8 Uses iText 8 Core for general handling of PDF generation and pdfHTML for handling HTML printing in PDF reports.
PDFBox Available only in the Java Generator. Uses the free and open source PDFBox library to generate PDF and manage HTML printing in PDF reports.
PDFPig Available only in the .NET Generator. Uses the free and open source PDFPig library to generate PDF reports.


Generators: Java, .NET
Level: Generator


This property allows you to choose between different library options to suit the specific needs of your application.

By selecting the iText (Legacy) value, you choose the library that has also been referenced by programs generated with versions prior to GeneXus 18 Upgrade 4. This means that:

It is important to note the different licensing schemes of iText 8. For more information, see iText License Model.

When choosing a particular library, do not expect the generated reports to be identical in all visual details. Each library has its own way of handling certain features, such as bold or italicized text. For example, iText provides methods to bold or italicize any text, while PDFBox does not provide those features and suggests the use of a specific font file (ttf) to accomplish this.

Note that PDFBox (available only in the Java Generator) is a low-level library that is not designed to create complex layouts, such as multi-level lists, tables, inline or internal styles. If a more sophisticated rendering of HTML content in PDF reports is required, it is recommended to consider using iText 8, which offers enhanced rendering capabilities for more advanced presentation in the generated PDF documents.

In addition, note that PDFPig does not support certain features. If you try to use an unsupported functionality, a message will be generated in the log indicating the attempted action and the reason for the failure. For more details, see SAC #54060.

Warning: Using iText (Legacy) value in the Java Generator is not recommended. It may imply security risks for your application.

Runtime/Design time

This property applies only at design time.

How to apply changes

To apply the corresponding changes when the property value is configured, execute Build any object with the purpose of generating the *.config files.

See Also

PDF Reports
External utilities used by GeneXus-generated web applications

Last update: April 2024 | © GeneXus. All rights reserved. GeneXus Powered by Globant