# Activating the Product

Learn how to activate Spread for Winforms using both online and offline methods. Follow step-by-step instructions for online activation using MESCIUS License Manager, Visual Studio, and Command Line Interface.

## Content

You can activate Spread for Winforms using online and offline methods listed below:

* Online Activation
    * Using MESCIUS License Manager
    * Using Visual Studio
    * Using Command Line Interface
* Offline Activation
    * Using MESCIUS License Manager
    * Using Command Line Interface

>type=note
> **Note:** Contact sales at “[us.sales@mescius.com](mailto:%E2%80%9Cus.sales@mescius.com)” to inquire about special license options for Azure DevOps or other similar build pipelines.

## Online Activation

### Using MESCIUS License Manager

1. After installation, navigate to C:\\ProgramData\\SA3\\Desktop on your machine, double click sa3client-ui.exe, and click **Activate Serial Key**.
    ![image](https://cdn.mescius.io/document-site-files/images/53cc02a8-8309-45ab-805b-7f04955cf00b/image-20260114.d15f97.png?width=700)
<br>
2. Enter the license key and click **Activate**.
    ![image](https://cdn.mescius.io/document-site-files/images/53cc02a8-8309-45ab-805b-7f04955cf00b/image-20260114.243644.png?width=700)
3. Click **OK**.
    ![image](https://cdn.mescius.io/document-site-files/images/53cc02a8-8309-45ab-805b-7f04955cf00b/image-20260114.c60c84.png?width=700)
4. Use MESCIUS License Manager to deactivate the license before moving the license to another machine. Click sa3client-ui.exe located in C:\\ProgramData\\SA3\\Desktop and click **Deactivate**.
    ![image](https://cdn.mescius.io/document-site-files/images/53cc02a8-8309-45ab-805b-7f04955cf00b/image-20260114.490958.png?width=700)

### Using Visual Studio

If you are trying to activate the product package installed from the NuGet Package Manager in Visual Studio, follow the steps mentioned below:

1. Create a project in Visual Studio.
2. Open NuGet Package Manager and install the product package from [nuget.org](https://www.nuget.org/packages/GrapeCity.Spread.WinForms/).
3. Build the project in Visual Studio. You will see a popup window during build.
4. Click on **Run the License Manager** in the popup window to launch the License Manager.
    ![image](https://cdn.mescius.io/document-site-files/images/53cc02a8-8309-45ab-805b-7f04955cf00b/image-20260113.1aee61.png?width=700)
<br>
5. Click the **Activate Serial Key** for the product in the window, and enter your serial key.
    ![image](https://cdn.mescius.io/document-site-files/images/53cc02a8-8309-45ab-805b-7f04955cf00b/image-20260114.8618a6.png?width=700)
<br>
6. After clicking the **Activate** button, License Manager will connect to our website. If successful, you will see the result:
    ![image](https://cdn.mescius.io/document-site-files/images/53cc02a8-8309-45ab-805b-7f04955cf00b/image-20260114.749d8e.png?width=700)
<br>
7. After closing the License Manager window, Visual Studio will continue the build.

### Using Command Line Interface

You can activate the product using the command line interface if the graphics UI of the License Manager does not work normally. This is useful, especially for a build machine.

1. After installation, open the command prompt.
2. Use the following commands to activate, deactivate, or refresh the license.

The following command line options are available for MESCIUS License Manager:

| **Command Option** | **Description** |
| -------------- | ----------- |
| **sa3client \( a \| activate \) \<serial\-key\>** | Activate license for the product.<ul><li>The `<serial-key>` should be in format “`Prefix-0000-0000-0000-0000-000`”. Different product has the different prefix and hyphens are not required.</li></ul> |
| **sa3client \( d \| deactivate \) \<serial\-key\-prefix\>** | Deactivate license for the product. <ul><li>Use \<serial-key-prefix> to indicate the license to deactivate. If you have only 1 license starts with a product code, it could be the product code; if you have several keys starts with a same product code, please use the product code and following 8 digits, e.g. `CDP-1234-5678`.</li></ul> |
| **sa3client \( r \| refresh \) \<serial\-key\-prefix\>** | Refresh license for the product.<ul><li>Refresh command is used to get the latest license of a serial key. If the refresh failed, you can activate the license with your serial key to fix it.</li><li>Use \<serial-key-prefix> to indicate the license to refresh. If you have only 1 license starts with a product code, it could be the product code; if you have several keys starts with a same product code, please use the product code and following 8 digits, e.g. `CDP-1234-5678`.</li></ul> |

## Offline Activation

Suppose the target machine cannot access the internet, but there is another machine that can access the [SA3](https://sa3.mescius.com/) website via web browser. In that case, you can activate a normal developer license in offline mode.

### Using MESCIUS License Manager

1. Run the sa3client-ui.exe from C:\\ProgramData\\SA3\\Desktop and try to activate a serial key without network access. Our tool will display the following error on the window.
    ![image](https://cdn.mescius.io/document-site-files/images/53cc02a8-8309-45ab-805b-7f04955cf00b/image-20260114.d52173.png?width=700)
<br>
2. Click the ![image](https://cdn.mescius.io/document-site-files/images/53cc02a8-8309-45ab-805b-7f04955cf00b/image-20260113.8d8832.png?width=25) icon at the top right to open the **Settings** page, and set the connection mode to **Offline**, then click **Back**.
    ![image](https://cdn.mescius.io/document-site-files/images/53cc02a8-8309-45ab-805b-7f04955cf00b/image-20260114.709cb4.png?width=700)
3. Click the **Activate Serial Key** button and enter your serial key. An **Offline Activation Request** dialog will appear, save the content to a local file.
    ![image](https://cdn.mescius.io/document-site-files/images/53cc02a8-8309-45ab-805b-7f04955cf00b/image-20260114.a0c98a.png?width=700)
4. Copy the <span data-teams="true">Offline Activation File</span> to another machine which could access the [SA3](https://sa3.mescius.com/) website.
5. On that machine, access [SA3](https://sa3.mescius.com/) website and click **Activate**.
    ![image](https://cdn.mescius.io/document-site-files/images/53cc02a8-8309-45ab-805b-7f04955cf00b/image-20260113.754ecf.png?width=700)
6. Paste the Request Code and click **Activate** button to generate the license data.
    ![image](https://cdn.mescius.io/document-site-files/images/53cc02a8-8309-45ab-805b-7f04955cf00b/image-20260113.2ac710.png)
7. Save the license data and copy it back to the original machine.
8. In the License Manager, click **Import Offline License**, paste the license data, and click **Activate**. The License is activated.
    ![image](https://cdn.mescius.io/document-site-files/images/53cc02a8-8309-45ab-805b-7f04955cf00b/image-20260114.bf3ba6.png?width=700)
    ![image](https://cdn.mescius.io/document-site-files/images/53cc02a8-8309-45ab-805b-7f04955cf00b/image-20260114.1c9bf2.png?width=700)

### Using Command Line Interface

1. Open the command prompt.
2. Use the following commands to activate or deactivate the license.

The following command line options are available for MESCIUS License Manager:

| **Command Option** | **Description** |
| -------------- | ----------- |
| **sa3client \( a \| activate \) \<serial\-key\> \[\( \-o \| \-\-output \) \<offline\-file\-path\>\]** | Activate license for the product.<ul><li>Use `--output` to perform an offline activation. You need to submit the generated offline activation file (located at the specified path) to the [SA3](https://sa3.mescius.com/) site or send it to our support team. Next, use `sa3client import` to import the license file returned from the [SA3](https://sa3.mescius.com/) site or support team.</li></ul> |
| **sa3client \( i \| import \) \<offline\-file\-path\>​** | Import the license file from the [SA3](https://sa3.mescius.com/) site or support team.. |
| **sa3client \( d \| deactivate \) \<serial\-key\-prefix\> \[\( \-o \| \-\-output \) \<offline\-file\-path\>\]** | Deactivae license for the product.<ul><li>Use `<serial-key-prefix>` to indicate the license to deactivate. If you have only 1 license starts with a product code, it could be the product code; if you have several keys starts with a same product code, please use the product code and following 8 digits, e.g. `CDP-1234-5678`.</li><li>Use `--output` to perform an offline deactivation. You need submit the generated offline-deactivation-file at the specified path to [SA3](https://sa3.mescius.com/) site, or send it to support team.</li></ul> |

>type=note
> **Note:** For both offline methods, the deactivation steps are similar to activation. So, you need to copy the <span data-teams="true">Offline Deactivation File</span> to the [SA3](https://sa3.mescius.com/) site to release the usage of the activation key.