Using IronXL License Keys
Get Your License Key
IronXL license keys allow you to deploy your project live without any watermark.
Licenses start at just $499 and include one free year of support and updates.
You can also try IronXL free for 30 days with a trial license key.
Step 1: Download the Latest Version of IronXL

Install with NuGet
Install-Package IronXL.Excel
The first thing we need to do is install the IronXL.Excel library, adding Excel functionality to the .NET framework.
Install with NuGet Package
- In Visual Studio, right-click on the project select "Manage NuGet Packages ..."
- Search for the IronXL.Excel package and install
Or
- Enter the Package Manager Console
- Type > Install-Package IronXL.Excel
PM > Install-Package IronXL.Excel
View the package on the NuGet site here.
DLL Direct Download Installation
Download the IronXL .NET Excel DLL and manually install into Visual Studio.
Step 2: Apply Your License Key
Set the license key inside your code
Add this code to the startup of your application, before IronXL is used.
IronXL.License.LicenseKey = "IRONXL-MYLICENSE-KEY-1EF01";
IronXL.License.LicenseKey = "IRONXL-MYLICENSE-KEY-1EF01";
IronXL.License.LicenseKey = "IRONXL-MYLICENSE-KEY-1EF01"
Set your key using Web.Config or App.Config in .NET Framework Applications
To apply a key globally to your application using Web.Config or App.Config, add the following key to your config file in appSettings.
<configuration>
....
<appSettings>
<add key="IronXL.LicenseKey" value="IronXL-MYLICENSE-KEY-1EF01"/>
</appSettings>
....
</configuration>
Setting license key in web.config issue
There is a known licensing issue: in ASP.NET projects targeted .NET framework version >= 4.6.2. The key stored in a web.config
file will NOT be picked up and used by the product.
To work around this issue it is recommended to read license key using ConfigurationManager from web.config
in the code and apply it to the License.LicenseKey.
Example:
With the above XML file, we can use ConfigurationManager to retrieve and pass the license key value to IronXL.License.LicenseKey property.
using System.Configuration;
string licenseKey = ConfigurationManager.AppSettings["IronXL.LicenseKey"];
IronXL.License.LicenseKey = licenseKey;
using System.Configuration;
string licenseKey = ConfigurationManager.AppSettings["IronXL.LicenseKey"];
IronXL.License.LicenseKey = licenseKey;
Imports System.Configuration
Private licenseKey As String = ConfigurationManager.AppSettings("IronXL.LicenseKey")
IronXL.License.LicenseKey = licenseKey
Ensure that IronXL.License.IsLicensed
returns true
to verify.
Set your key using a .NET Core appsettings.json file
To apply a key globally to your application to a .NET Core:
- Add a JSON file to your project called appsettings.json in the root directory of your project
- Add a 'IronXL.LicenseKey' key to your JSON config file. The value should be your license key.
- Ensure that the file properties include Copy to Output Directory: Copy always
- Ensure that
IronXL.License.IsLicensed
returnstrue
to verify.
File: appsettings.json
{
"IronXL.LicenseKey":"IronXL-MYLICENSE-KEY-1EF01"
}
Step 3: Test your key
Test if your key has been installed correctly.
// Check if a given license key string is valid.
bool result = IronXL.License.IsValidLicense("IronXL-MYLICENSE-KEY-1EF01");
// Check if IronXL is licensed successfully
bool is_licensed = IronXL.License.IsLicensed;
// Check if a given license key string is valid.
bool result = IronXL.License.IsValidLicense("IronXL-MYLICENSE-KEY-1EF01");
// Check if IronXL is licensed successfully
bool is_licensed = IronXL.License.IsLicensed;
' Check if a given license key string is valid.
Dim result As Boolean = IronXL.License.IsValidLicense("IronXL-MYLICENSE-KEY-1EF01")
' Check if IronXL is licensed successfully
Dim is_licensed As Boolean = IronXL.License.IsLicensed
Note: After adding a license always remember to clean and republish you application to avoid potential mistakes in deployment.
Step 4: Get started with your project
Follow our tutorial on how to Get Started with IronXL.
Questions?
If you have any questions, reach out to support@ironsoftware.com