Migration guide from iText 5 to iText 7

Installation instructions

Instead of having everything in one giant jar (or DLL), we have split iText into several independent parts. You pay only for the parts you use, and your application only needs to load those parts that are actually being used.

  • Installation instructions for java can be found here
  • Installation instructions for .NET can be found here.

Keep in mind you will not be able to simply replace dependencies and expect your code to work. Some migration effort is to be expected. 

Dependency changes

Dependency iText5 iText7
logback (java) N/A 1.1.3
log4net (NET) N/A 2.0.8

 

For the full list of dependencies, check out the POM file of our java project.

License key upgrade

Several improvements have been made to the license key mechanism. We also added the possibility of automated tracking for volume based licenses. For more information, contact your sales representative.

If you have any difficulties with the license key mechanism, check out the license key FAQ.

Conceptual API changes

iText5 had grown organically over the years, adding bugfixes and new functionality on top of the architecture. This lead to a sometimes messy and counter-intuitive design.

iText7 is a complete re-design of iText5, it includes all the functionality of iText5, but in a way that provides a clear and consistent API. Special attention was given to rendering HTML to PDF (which in iText5 was possible using XMLWorker). XMLWorker, which was originally intended to convert small snippets of HTML, turned out to be a popular addon, and more and more features were added.

pdfHTML is the successor to XMLWorker, and similar to the relationship between iText5 and iText7, pdfHTML was built to be clear and understandable.

iText7 features a new rendering framework (to accommodate pdfHTML) and several changes in the document model. iText7 puts more emphasis on the separation of the high-level document model and the low level PDF operators.

With the addons we provide, we also extended our internation support. PdfCalligraph allows you to easily handle Arabic, Hindi, Tamil and many other complex scripts. This is another conceptual difference. In stead of having everything in one giant jar (or DLL), we have split iText into several independent parts.

You pay only for the parts you use, and your application only needs to load those parts that are actually being used.

Contact

Still have questions? 

We're happy to answer your questions. Reach out to us and we'll get back to you shortly.

Contact us
Stay updated

Join 11,000+ subscribers and become an iText PDF expert by staying up to date with our new products, updates, tips, technical solutions and happenings.

Subscribe Now