Skip to end of metadata
Go to start of metadata
Contents Summary

You can use GroupDocs.Parser 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 Version Limitations

You can easily download GroupDocs.Parser 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 100 files per session

The limit effects any operation per session (except for encoding detection)

Extracting raw text

Only 20 lines per file
1600 symbols
Only the first 5 pages (slides, sheets)
+ Evaluation marks


Extracting formatted text

Only 20 lines per file
Only 20 rows (for spreadsheets)
1600 symbols
Only the first 5 pages (slides, sheets)
+ Evaluation marks


Extracting structured text

Only 20 rows (for spreadsheets)
1600 symbols
Only the first 5 pages (slides, sheets)
+ Evaluation marks


Reading metadata

Only 5 properties per file


Detecting media type

Only file count restrictions

The limit effects only detecting by content

Encoding detection

Without any restrictions


More Restrictions

Particular formats have more restrictive licensing restrictions:

  • Slides Formats
    Text is trimmed to several characters + Evaluation mark
  • Email Formats
    A watermark instead of an email's body is extracted
  • Pdf Formats
    Text is trimmed to several characters + Evaluation mark


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.Parser API if you want to avoid its evaluation limitations. 

The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Parser's JAR file and specify the file name without a path, as shown in the examples below.

Applying License from File

The code below will explain how to apply product license.

Applying License from Stream

The following example shows how to load a license from a stream.

Applying Metered License

Since version 18.9, the Metered licensing security has been improved. Metered licensing is now applicable only in Java runtime version 8u101 or above. Please use other types of licensing if you are using v18.9 or greater in Java 7.

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.

Following is the sample code demonstrating how to set metered public and private keys.


When to Apply a License

Follow these simple rules:

  • The license only needs to be set once per application domain.
  • You need to set the license before using any other GroupDocs.Parser classes.
  • Calling License.setLicense multiple times is not harmful but simply wastes processor time.

If you are developing a class library, you can call License.setLicense from a static constructor of your class that uses GroupDocs.Parser. The static constructor will execute before an instance of your class is created making sure GroupDocs.Parser license is properly set.

  • No labels