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 from version 8 you set your license key via the ExcelPackage.License.SetCommercial(string) method or using your config file or an environment variable. See Information to developers below.

You can find your license key under My Licenses in your account or on the license document.

If you use a version prior to EPPlus 8, please see Getting started EPPlus 7

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 8 and later from the EPPlus nuget feed.

As a holder of a commercial license you must set your license key before using EPPLus in your code.

The Licence key can be set in three different ways:

1. Use the ExcelPackage.License.SetCommercial(string) method
            // To set your license key from code, use the static method ExcelPackage.License.SetCommercial
ExcelPackage.License.SetCommercial("<Your License Key>");  //Sets your license key in code.

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

}
2. appSettings.json
            {
    {
    "EPPlus": {
        "ExcelPackage": {
            "License": "Commercial:<Your License Key>"
            }
        }
    }
}

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

            <appSettings>
    <!--The license context used-->
    <add key="EPPlus:ExcelPackage:License" value="Commercial,<Your License Key>" />
</appSettings>
3. Set the environment variable 'EPPlusLicense'

This might be the easiest way of configuring this. Set the variable to Commercial:<Your License Key> The example below set the license key using the SETX command in the Windows console on the user level, but you can set it in any way you prefer. 

            > SETX EPPlusLicense "Commercial:<Your License Key>"
The variable can be set on the process, user or machine 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.