After the purchase - getting started

Below is some information on how to proceed after your purchase of EPPlus licenses.

License

There are no license keys required for EPPlus 6/7. But as a holder of a commercial license you should set the configuration property LicenseContext to Commercial. See Information to developers below.

From EPPlus 8 and later you need to set you license key for commercial use as described here:
Getting started EPPlus 8

Please ensure that all developers using EPPlus get this information

Invite more users from your company

You can invite more users to our web portal - for example if you want to change the payment contact or if you want to invite developers covered by the license to get access to our online support

Here is how you invite a new user: in the left menu when you are logged in - click your company name, then click the Manage contacts button. You can either invite someone as administrator or support user only. The support user will not have access to licenses, invoices, payment methods, etc.

Change your license

You can at any time login to our website and change your license (update number of licenses or cancel at the end of the license period). Just click My licenses in the left menu when you are logged in.

Information to developers

Installation: Install EPPlus 6/7 from the EPPlus nuget feed.

As a holder of a commercial license, EPPlus 6/7 should be configured as described below - setting the value to Commercial.

EPPlus checks the LicenseContext only when a debugger is attached, so it is not necessary to have this set in a production environment when your code is compiled in Release mode.

The LicenceContext configuration parameter can be set in three different ways:

1. Use the LicenseContext property on the ExcelPackage class
            
// If you are a commercial business and have
// purchased commercial licenses use the static property
// LicenseContext of the ExcelPackage class:
ExcelPackage.LicenseContext = LicenseContext.Commercial;

using(var package = new ExcelPackage(new FileInfo("MyWorkbook.xlsx")))
{

}
            
        
2. appSettings.json
            
{
    {
    "EPPlus": {
        "ExcelPackage": {
            "LicenseContext": "Commercial" //The license context used
            }
        }
    }
}
        
        

...or in the app.config...

            

<appSettings>
    <!--The license context used-->
    <add key="EPPlus:ExcelPackage.LicenseContext" value="Commercial" />
</appSettings>

            
            
3. Set the environment variable 'EPPlusLicenseContext'

This might be the easiest way of configuring this. Set the variable to Commercial

Important! The environment variable should be set at the user level.

Developer resources

A more detailed getting started information is available in our developer wiki.

Our sample projects on github is a good starting point. Here you will also find the source code for EPPlus, our issue tracker and branches for our ongoing new development.

More developer information can be found here.