Free / Trial / Time Limited / Professional

GemBox.Spreadsheet for Java is a Java library for processing Excel files that has four working modes:

Every working mode uses the same GemBox.Spreadsheet.jar file and delivers the same performance and set of features, but has some restrictions (except for the Professional mode).

Before using any other member from GemBox.Spreadsheet for Java library, you must call a SpreadsheetInfo.setLicense method to set the working mode.

Free Excel library

The default behavior of the Free mode is that a FreeLimitReachedException is thrown when loading or saving an Excel file with more than 150 rows or 5 sheets.

You can change this behavior to achieve the trimming of spreadsheet content to the first 150 rows and 5 sheets if you handle a FreeLimitReached event by adding a listener using SpreadsheetInfo.addFreeLimitReachedListener and setting FreeLimitEventArgs.setFreeLimitReachedAction to FreeLimitReachedAction.STOP.

You can use the Free mode for any purpose, including use in commercial applications.

// Set license key to use GemBox.Spreadsheet for Java in a Free mode.
SpreadsheetInfo.setLicense("FREE-LIMITED-KEY");

// Stop reading/writing a spreadsheet when the free limit is reached.
SpreadsheetInfo.addFreeLimitReachedListener(eventArguments -> eventArguments.setFreeLimitReachedAction(FreeLimitReachedAction.STOP));

Trial Excel library

You can use the Trial mode to evaluate beyond the first 150 rows and 5 sheets. Both Free and Trial modes use the same FREE-LIMITED-KEY key and can be used for an unlimited time period.

To set the mode to Trial, you need to handle a FreeLimitReached event by adding a listener using SpreadsheetInfo.addFreeLimitReachedListener and setting FreeLimitEventArgs.setFreeLimitReachedAction to FreeLimitReachedAction.CONTINUE_AS_TRIAL.

The limitation of Trial mode is when loading or saving an Excel file approximately 5% of randomly selected cells will have their value replaced with TRIAL.

// Set license key to use GemBox.Spreadsheet for Java in a Free mode.
SpreadsheetInfo.setLicense("FREE-LIMITED-KEY");

// Continue to use the component in a Trial mode when free limit is reached.
SpreadsheetInfo.addFreeLimitReachedListener(eventArguments -> eventArguments.setFreeLimitReachedAction(FreeLimitReachedAction.CONTINUE_AS_TRIAL));

Time Limited Excel library

You can also use the Time Limited mode to evaluate beyond the first 150 rows and 5 sheets.

To set the mode to Time Limited, you need to use a temporary or time-limited key, which you can get by contacting us.

The limitation of Time Limited mode is that it can be used only for 30 days.

// Set license key to use GemBox.Spreadsheet for Java in a Time Limited mode.
SpreadsheetInfo.setLicense("XX−<START DATE>−<END DATE>-XXXXXXXXXX");

Professional Excel library

To set the mode to Professional, you need to use a professional key which you can get by purchasing a license.

The Professional mode has no limitations, and the professional keys are perpetual (they can be used forever).

// Set license key to use GemBox.Spreadsheet for Java in a Professional mode.
SpreadsheetInfo.setLicense("XXXXXXXXXX");

Important, every developer working on an application that uses the GemBox component in Professional mode, must be covered with a license. The professional keys are uniquely generated for each license and must be kept confidential.

For more information, please read the FAQ page and the product's EULA.

If you're working on an open-source project, please make sure that your license is not publicly accessible.


Next steps

GemBox.Spreadsheet for Java is a component that enables you to read, write, edit and convert spreadsheet files from your applications using one simple API.

Download Buy