Share via

MAUI: To build this project, the following workloads must be installed: wasi-experimental

Sreenivasan, Sreejith 195 Reputation points
2025-11-17T07:19:56.01+00:00

I am getting below error for my MAUI project:

To build this project, the following workloads must be installed: wasi-experimental To install these workloads, run the following command: dotnet workload restore

I have experienced the same issue before when I install the JAVA in my system and after uninstalling JAVA this issue got vanished. But today I didn't install anything. Last day also the project was working fine. Also I am not using wasi in my project.

I run the dotnet workload list command and below is its screenshot:

User's image

I tried running the dotnet workload update, but I don't have admin role. So it returns below error: Workload update failed: The operation has timed out.

What is the reason behind this issue? I saw this happens after Visual Studio updates. But I didn't do any updates.

Do we need admin access to fix this issue and what are the commands we need to run?

My VS Version: Microsoft Visual Studio Professional 2022 (64-bit) - Current Version 17.14.18 (October 2025)

Developer technologies | .NET | .NET MAUI
0 comments
Answer accepted by question author
  1. Jack Dang (WICLOUD CORPORATION) 3,965 Reputation points Microsoft External Staff Moderator
    2025-11-17T09:52:28.2533333+00:00

    Hi @Sreenivasan, Sreejith ,

    Thanks for reaching out.

    The error you’re seeing:

    “To build this project, the following workloads must be installed: wasi‑experimental”

    typically occurs because the .NET MAUI workloads or SDK manifests are out of sync or partially corrupted. Even if your project doesn’t target WebAssembly or WASI, the build system may incorrectly think this workload is required.

    Here are steps to resolve the issue

    1. Clean and restore your project (no admin rights needed):
    dotnet clean
dotnet restore
dotnet workload restore
dotnet workload repair

    The dotnet workload repair command ensures all installed workloads are properly registered.

    https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-workload-repair

    1. Check installed workloads:
    dotnet workload list

    This will show which workloads are currently installed.

    https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-workload-list

    1. Simplify your project path: Make sure your project folder path doesn’t contain special characters (e.g., @, (, )), as these can cause build or workload resolution issues.
    2. If the issue persists, you may need admin assistance to:
    dotnet workload install maui
dotnet workload update

    Admin rights are required if workloads need to be installed or updated system-wide.

    https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-workload-install

    • Admins can also repair or reinstall the .NET SDK or workloads if necessary.

    Following these steps should restore proper workload registration and allow your MAUI project to build successfully.

    Hope this helps! If my answer was helpful - kindly follow the instructions here so others with the same problem can benefit as well.

    1 person found this answer helpful.

0 additional answers

Sort by: Most helpful
Most helpful Newest Oldest

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.