Skip to content

Updated the Blazor common UG documentation #7033

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Oct 30, 2025
Merged

Updated the Blazor common UG documentation #7033

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
de8b00b
Updated the Blazor common UG documentation
Backiaraj Oct 29, 2025
a6a2fc1
Merge branch 'hotfix/hotfix-v31.2.2' of https://github.com/syncfusion…
Backiaraj Oct 29, 2025
37c1975
Updated the Blazor common UG documentation
Backiaraj Oct 30, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
79 changes: 40 additions & 39 deletions blazor/installation/common-installation-errors.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
layout: post
title: Installation Errors in Blazor - Syncfusion
description: Learn here about the common installation errors and solution to those errors in Syncfusion Blazor Components installation.
title: Common installation errors in Blazor | Syncfusion
description: Understand common Syncfusion Blazor installer errors, their causes, and solutions including unlock key issues, license expiration, concurrent installers.
platform: Blazor
component: Common
control: Common
documentation: ug
---

# Common Installation Errors
# Common installation errors

This article describes the most common installation errors, as well as the causes and solutions to those errors.

Expand All @@ -21,89 +21,90 @@ This article describes the most common installation errors, as well as the cause

**Error Message:** Sorry, the provided unlock key is a trial unlock key and cannot be used to unlock the licensed version of our Essential Studio<sup style="font-size:70%">&reg;</sup> for Blazor installer.

![Installation Unlock Error](images/installation-error-1.png)
![Unlock key error when using a trial key with the licensed installer](images/installation-error-1.png)

**Reason** <br /> You are attempting to use a Trial unlock key to unlock the licensed installer.
**Reason:** <br/> A trial unlock key is being used with the licensed installer.

**Suggested solution** <br /> Only a licensed unlock key can unlock a licensed installer. So, to unlock the Licensed installer, use the Licensed unlock key. To generate the licensed unlock key, refer to [this](https://support.syncfusion.com/kb/article/2757/how-to-generate-syncfusion-setup-unlock-key-from-syncfusion-support-account) article.
**Suggested solution:** Only a licensed unlock key can unlock a licensed installer. So, to unlock the Licensed installer, use the Licensed unlock key. To generate the licensed unlock key, refer to [this](https://support.syncfusion.com/kb/article/2757/how-to-generate-syncfusion-setup-unlock-key-from-syncfusion-support-account) article.

## License has expired

**Error Message:** Your license for Syncfusion<sup style="font-size:70%">&reg;</sup> Essential Studio<sup style="font-size:70%">&reg;</sup> for Blazor has been expired since {date}. Renew your subscription and try again.

***Online Installer***
***Online installer***

![Installation License Expired Error](images/installation-error-2.png)
![License expired message in the web installer](images/installation-error-2.png)

**Reason** <br /> This error message will appear if your license has expired.
**Reason:** This error message will appear if your license has expired.

**Suggested solution** <br /> You can choose from the options listed below.
**Suggested solution:** Choose one of the following options.

1. You can renew your subscription [here](https://www.syncfusion.com/account/my-renewals).
2. You can get a new license [here](https://www.syncfusion.com/sales/products).
3. You can reach out to our sales team by emailing [[email protected]](mailto:[email protected]).
4. You can also extend the 30-day trial period after your trial license has expired.
1. Renew the subscription [here](https://www.syncfusion.com/account/my-renewals)
2. Purchase a new license [here](https://www.syncfusion.com/sales/products)
3. Contact sales: [email protected]
4. If applicable, extend the 30‑day trial period.

## Unable to find a valid license or trial

**Error Message:** Sorry, we are unable to find a valid license or trial for Essential Studio<sup style="font-size:70%">&reg;</sup> for Blazor under your account.

***Offline installer***

![Installation Offline Installer Error](images/installation-error-3.png)
![Account has no valid license or trial in the offline installer](images/installation-error-3.png)

***Online installer***

![Installation Online Installer Error](images/installation-error-4.png)
![Account has no valid license or trial in the web installer](images/installation-error-4.png)

**Reason** <br /> The following are possible causes of this error:
**Reason:** One of the following is true:

* When your trial period expired
* When you don’t have a license or an active trial
* You are not the license holder of your license
* Your account administrator has not yet assigned you a license.
* The 30‑day trial has expired
* The account has no license or active trial
* The user is not the license holder for the product
* The account administrator has not assigned a license to the user

**Suggested solution** <br />
1. You can get a new license [here](https://www.syncfusion.com/sales/products).
2. Contact your account administrator.
3. Send an email to [[email protected]](mailto:[email protected]) to request a license.
4. You can reach out to our sales team by emailing [[email protected]](mailto:[email protected]).
**Suggested solution:**
1. Purchase a license: https://www.syncfusion.com/sales/products
2. Ask the account administrator to assign a license in Syncfusion account portal
3. Request assistance: [email protected]
4. Contact sales: [email protected]

## Unable to install because of another installation

**Error Message:** Another installation is in progress. You cannot start this installation without completing all other currently active installations. Click cancel to end this installer or retry to attempt after currently active installation completed to install again.

![Installation Error Another MSI Running](images/installation-error-5.png)
![Another installation in progress error dialog](images/installation-error-5.png)

**Reason:** You are trying to install when another installation is already running in your machine.

**Reason** <br /> You are trying to install when another installation is already running in your machine.
**Suggested solution:** Open and kill the msiexec process in the task manager and then continue to install Syncfusion. If the problem is still present, restart the computer and try Syncfusion<sup style="font-size:70%">&reg;</sup> installer.

**Suggested solution** <br /> Open and kill the msiexec process in the task manager and then continue to install Syncfusion. If the problem is still present, restart the computer and try Syncfusion<sup style="font-size:70%">&reg;</sup> installer.
1. Open the Windows Task Manager.
1. Open Windows Task Manager.
2. Browse the Details tab.
3. Select the msiexec.exe and click **End task**.

![Installation Error MSIEXEC Kill](images/installation-error-6.png)
![Windows Task Manager showing msiexec.exe to end task](images/installation-error-6.png)

## Unable to install due to controlled folder access

***Offline***

**Error Message:** Controlled folder access seems to be enabled in your machine. The provided install or samples location (e.g., Public Documents) is protected by the controlled folder access settings.
**Error Message:** Controlled folder access seems to be enabled on this machine. The provided install or samples location (for example, Public Documents) is protected by controlled folder access settings.

![Installation Offline Installer Error Controlled Folder Access](images/installation-error-7.png)
![Offline installer controlled folder access warning](images/installation-error-7.png)

***Online***

**Error Message:** Controlled folder access seems to be enabled in your machine. The provided install, samples, or download location (e.g., Public Documents) is protected by the controlled folder access settings.
**Error Message:** Controlled folder access seems to be enabled on this machine. The provided install, samples, or download location (for example, Public Documents) is protected by controlled folder access settings.

![Installation Online Installer Error Controlled Folder Access](images/installation-error-8.png)
![Web installer controlled folder access warning](images/installation-error-8.png)

**Reason** <br /> You have enabled controlled folder access settings on your computer.
**Reason:** You have enabled controlled folder access settings on your computer.

***Suggested solution***
**Suggested solution:**

**Suggestion 1:**
* We will ship our demos in the public documents folder by default.
* Syncfusion demos are installed to the Public Documents folder by default.
* You have controlled folder access enabled on your machine, so our demos cannot be installed in the documents folder. If you need to install our demos in the Documents folder, follow the steps in this [link](https://support.microsoft.com/en-us/windows/allow-an-app-to-access-controlled-folders-b5b6627a-b008-2ca2-7931-7e51e912b034) and disable the controlled folder access.
* You can enable this option after the installing our Syncfusion<sup style="font-size:70%">&reg;</sup> setup.

Expand Down
26 changes: 13 additions & 13 deletions blazor/installation/install-nuget-packages.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
layout: post
title: Install Syncfusion Blazor NuGet packages - Syncfusion
description: Learn here about the how to install Syncfusion Blazor NuGet packages from Package manager and NuGet manager.
title: Install Syncfusion Blazor NuGet packages | Syncfusion
description: Learn here about how to install Syncfusion Blazor NuGet packages using the Package Manager UI, .NET CLI, and Package Manager Console. Explore to more details.
platform: Blazor
component: Common
control: Common
documentation: ug
---

# Install Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages
# Install Syncfusion® Blazor NuGet packages

## Overview

Expand All @@ -22,27 +22,27 @@ The NuGet **Package Manager UI** allows you to search, install, uninstall, and u

1. Right-click on the Blazor application or solution in the Solution Explorer, and choose **Manage NuGet Packages...**

![Manage NuGet Packages add-in](images/ManageNuGet.png)
![Open Manage NuGet Packages from Solution Explorer](images/ManageNuGet.png)

As an alternative, after opening the Blazor application in Visual Studio, go to the **Tools** menu and after hovering **NuGet Package Manager**, select **Manage NuGet Packages for Solution...**

2. The Manage NuGet Packages window will open. Navigate to the **Browse** tab, then search for the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages using a term like **"Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor"** and select the appropriate Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet package for your development.

N> The [nuget.org](https://api.nuget.org/v3/index.json) package source is selected by default in the Package source drop-down. If your Visual Studio does not have nuget.org configured, follow the instructions in the [Microsoft documents](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-visual-studio#package-sources) to set up the nuget.org feed URL.
N> The [nuget.org](https://api.nuget.org/v3/index.json) package source is selected by default. If Visual Studio does not have nuget.org configured, follow the instructions in the [Microsoft documents](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-visual-studio#package-sources) to set up the nuget.org feed URL.

![Blazor NuGet Packages Search](images/NuGetsearch.png)
![Search for Syncfusion Blazor packages in the Browse tab](images/NuGetsearch.png)

3. When you select a Blazor package, the right side panel will provide more information about it.

4. By default, the package is selected with the latest version. You can choose the required version and click the **Install** button and accept the license terms. The package will be added to your Blazor application.

![Blazor NuGet Packages Install](images/InstallNuGet.png)
![Install a Syncfusion Blazor package from the Package Manager UI](images/InstallNuGet.png)

5. At this point, your application has all the required Syncfusion<sup style="font-size:70%">&reg;</sup> assemblies, and you will be ready to start building high-performance, responsive app with [Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor components](https://www.syncfusion.com/blazor-components). Also, you can refer to the [Blazor help document](https://blazor.syncfusion.com/documentation/introduction) for development.

## Installation using Dotnet (.NET) CLI

The [dotnet Command Line Interface (CLI)](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-dotnet-cli), allows you to add, restore, pack, publish, and manage packages without making any changes to your application files. [Dotnet add package](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-add-package?tabs=netcore2x) adds a package reference to the application file, then runs [dotnet restore](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-restore?tabs=netcore2x) to install the package.
The [dotnet Command Line Interface (CLI)]((https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-dotnet-cli)) lets you add, restore, pack, publish, and manage packages without making any changes to your application files. [Dotnet add package](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-add-package?tabs=netcore2x) adds a package reference to the application file, then runs [dotnet restore](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-restore?tabs=netcore2x) to install the package.

Follow the below instructions to use the dotnet CLI command to install the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages.

Expand Down Expand Up @@ -72,7 +72,7 @@ The **Package Manager Console** saves NuGet packages installation time since you

1. To show the Package Manager Console, open your Blazor application in Visual Studio and navigate to **Tools -> NuGet Package Manager -> Package Manager Console**.

![Package Manager Console ](images/console.png)
![Package Manager Console in Visual Studio](images/console.png)

2. The **Package Manager Console** will be shown at the bottom of the screen. You can install the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages by entering the following NuGet installation commands.

Expand All @@ -84,21 +84,21 @@ The **Package Manager Console** saves NuGet packages installation time since you

**For example:** Install-Package Syncfusion.Blazor.Grid

N> You can find the list of Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages which are published in nuget.org from [here](https://www.nuget.org/packages?q=Tags%3A%22Blazor%22+syncfusion)
N> Browse Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages on [NuGet.org](https://www.nuget.org/packages?q=Tags%3A%22Blazor%22+syncfusion).

***Install specified Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet package in specified Blazor application***

The following command will install the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet package in the given Blazor application.

```Install-Package <Package Name> - ProjectName <Project Name>```
```Install-Package <Package Name> -ProjectName <Project Name>```

**For example:** Install-Package Syncfusion.Blazor.Grid -ProjectName SyncfusionBlazorApp

3. By default, the package will be installed with latest version. You can give the required version with the -Version term like below to install the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages in the appropriate version.

```Install-Package Syncfusion.Blazor.Grid -Version 19.2.0.44```

![Package Manager Console Output ](images/ConsoleInstallationOutput.png)
![Package Manager Console output showing installed package](images/ConsoleInstallationOutput.png)

4. The NuGet package manager console will install the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet package as well as the dependencies it has. When the installation is complete, the console will show that your Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor package has been successfully added to the application.

Expand Down
Loading