Licensing and Evaluation Limitations

You can use GroupDocs.Comparison without the license. The usage and functionalities are pretty much same as the licensed one but you will face few limitations while using the non-licensed API.

Evaluation Limitations

You can easily download GroupDocs.Comparison for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license:

  • Only first 3 document pages with simple structure are processed.
  • PDF documents should not have more then four elements in any collection.
  • Trial badges are placed in the document on the top of each page.


The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don’t modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Comparison API if you want to avoid its evaluation limitations.  License can be applied using file path or stream.

Apply License Using License File Path

Code given below justifies how to apply license using file path.

Apply License Using License File Stream

Code given below explains how to apply license using stream.

Calling License#setLicense multiple times is not harmful but simply wastes processor time. Call License#setLicense in your startup code, before using GroupDocs.Comparison API for compare two or more files in applications on the Java platform. Compiled file shows line-by-line difference of content, paragraphs, characters, styles, shapes and positions. classes.

Setting Metered License

You can also set Metered license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to Metered Licensing FAQ section.

Create metered object and use method setMeteredKey

To check current consumption quantity:

  1. Call method getConsumptionQuantity of the Metered class.
  2. It will return the amount/quantity of API requests that you have consumed so far.
  3. call method getConsumptionCredit of the Metered class.
  4. It will return the credit that you have consumed so far.