Documents for Excel, Java Edition Documentation
Get Started / License Information
In This Topic
    License Information
    In This Topic

    Types of Licenses

    GcExcel Java supports the following types of license:


    When you download GcExcel Java for the first time, the product works under No-License i.e Unlicensed mode with a few limitations, that are highlighted below.

    Evaluation License

    GcExcel Java trial license is available for one month for users to evaluate the product and see how it can help with their comprehensive project requirements.

    In order to evaluate the product, you can contact and ask for the evaluation license key. The evaluation key is sent to users via email and holds valid for 30 days. After applying the evaluation license successfully, the product can be used without any limitations until the license date expires.

    After the expired date, the following limitations will be triggered:


    GcExcel Java production license is issued at the time of purchase of the product. If you have production license, you can access all the features of GcExcel Java without any limitations.

    Apply License To GcExcel

    Applying license to GcExcel Java involves completing the following steps to create an application and license GcExcel:

    Step 1: Create a Java Project and add dependency for GcExcel library

    1. In Eclipse IDE, select File | New | Java Project to create a new Java project.
    2. In Project name field, enter the name of your project and click Next.
    3. In Java settings, under Libraries tab, click Add External JARs..
    4. Select the gcexcel-2.2.0.jar to add it to your project.
    5. Click Finish.
    6. The jar file will be added under the Referenced Libraries in your project.

    Step 2 - Add dependency for processing JSON

    Before you proceed with applying license to GcExcel Java, you need to first download the JSON Processing Default Provider and add reference to  javax.json as dependency library in your Java project.

    If you're using javax.json-1.1 and above, make sure you add the following two files in your java project in order to license it successfully -:



    Step 3 - Create a basic application with GcExcel Java

    To create a basic application with GcExcel Java, refer to the following tasks:

    1. Add Namespaces

      In, import the following namespaces -

      import com.grapecity.documents.excel.*;
      import com.grapecity.documents.excel.drawing.*;

    2. Create a new workbook, access the default worksheet and configure settings

      After applying product license, you can create a new workbook, access the default worksheet and set the tab color. You can also configure other settings like the default row height and column width of the worksheet. An example code is shown below:

      Workbook workbook = new Workbook();

      IWorksheet worksheet = workbook.getWorksheets().get(0);

    3. Save the workbook

      After customizing the worksheet, you can save the workbook with the desired name and provide the required path. An example code is shown below:"GcExcelFeatures.xlsx");

      You can view the saved GcExcelFeatures.xlsx file at the specified location.

    Step 4 - Add License

    1. Add the license key in one of the ways, either to license all the workbooks or just a specific workbook. These are explained below:
      • To license all the workbooks in a project, add the license by using SetLicenseKey method. This will license all the workbooks
        Copy Code
         Workbook.SetLicenseKey("Your License Key");

      • To license an instance of the workbook, add the license key when an instance of workbook is created. Add the following code.
        Copy Code
        Workbook workbook = new Workbook("Your License Key");

    Step 5 - Build and Run the Project

    When you finish, build and run your project. You will notice that the GcExcelFeatures.xlsx file is created at the specified location on your system.