> For the complete documentation index, see [llms.txt](https://docs.soraco.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.soraco.co/docs/how-to/how-to-activate-a-license.md).

# How to activate a license

The recommended and fastest approach to activate a license is to use the QLM License Wizard. The QLM License Wizard is a full featured standalone application (or .NET WinForm control) that you can ship with your application. It enables your end-user to activate a license online or offline, deactivate a license as well as download and install the latest version of your application (Windows only).

If you prefer to create your own user interface to activate the license, the steps below describe the procedure to follow:

* Use the QLM Management Console / Protect Your Application wizard to generate the LicenseValidator class that corresponds to the programming language of your application
* When your application starts up, call LicenseValidator.ValidateLicenseAtStartup
* The first time you call ValidateLicenseAtStartup, it should return false.
* Prompt the user to enter an Activation Key
* Call LicenseValidator.ValidateLicense to validate the Activation key entered by the user. There are 3 cases you may want to consider to request an activation of the license:
  * The license has not been activated yet
  * The license is activated but has expired
  * The license  has been activated for another version of the product.
* Call [QlmLicense.ActivateLicense](/docs/api-reference/.net-api/qlmlicense/application-methods/activatelicense.md) to activate the license
* Call [QlmLicense.ParseResults](https://support.soraco.co/hc/en-us/articles/207611673-QlmLicense-ParseResults) to get the results of the activation
* If ParseResults return true, the activation was successful.
* You should finally call [QlmLicense.StoreKeys](/docs/api-reference/.net-api/qlmlicense/client-side-methods/storekeys.md) to store the Computer Key generated by the server

 

Example:

{% code overflow="wrap" %}

```csharp
private void ActivateLicense(string activationKey, ref string licenseMessage)
{ 
     string computerID = Environment.MachineName;
     bool needsActivation = false;
     string returnMsg = string.Empty;


     if (lv.ValidateLicense (activationKey, string.Empty, ref computerID, ELicenseBinding.ComputerName, ref needsActivation, ref returnMsg) == false)
     {

         if (lv.WrongProductVersion || lv.EvaluationExpired || needsActivation )
         {
             string response;
             lv.QlmLicenseObject.ActivateLicense(string.Empty, activationKey, computerID, Environment.MachineName, "5.0.00", string.Empty, out response);

             ILicenseInfo li = new LicenseInfo();
             string message = string.Empty;
             if (lv.QlmLicenseObject.ParseResults(response, ref li, ref message))
             {
                 lv.QlmLicenseObject.StoreKeys(activationKey, li.ComputerKey);
             }
         }
      }
}
```

{% endcode %}