The NUnit3 TestAdapter for Visual Studio, all versions from 2012 and onwards, and DotNet (incl. .Net core), versions .net framework 4.6.2 or higher, .net 8 or higher. Note that this package ONLY contains the adapter, not the NUnit framework. For VS 2017 and forward, you should add this package to every test project in your solution. (Earlier versions only require a single adapter package per solution.)
Get Started
$ dotnet add package NUnit3TestAdapterReadme
NUnit 3 VS Test Adapter
The NUnit 3 Test Adapter runs NUnit 3.x and higher tests in Visual Studio 2012 and newer.
You can download the latest release version 
or the latest developer build version
Builds on main
Support
Ask support questions 
Documentation
The NUnit3TestAdapter wiki is the best place to start.
Also check the release notes.
License
The NUnit 3 Test Adapter is Open Source software released under the 
.
Development
Visual Studio 2026 is the recommended version to build and test the adapter.
Use .\build at the command line to build (compile) the solution.
Use .\build -t test at the command line to build and run unit tests.
Use .\build -t acceptance at the command line to build and run acceptance tests.
Use .\build -t package to create a package.
To run and debug tests on .NET Framework, load DisableAppDomain.runsettings.
From Visual Studio 2019 version 16.2 preview 4 it is possible to run tests against a selected target framework in the test project, so one can use this to run .NET Core tests.
An alternative approach is to make use of the command line. If you need to frequently debug into .NET Core tests, you can temporarily switch the order of the <TargetFrameworks> in NUnit.TestAdapter.Tests.csproj.
The mock-assembly tests are not for direct running.
See https://github.com/nunit/docs/wiki/Packaging-the-V3-Adapter for more details.
Debugger source-stepping
The NuGet package contain source-linked PDBs for the adapter. If you’re in the middle of a debugging session and realize you’d like to be able to step into NUnit adapter code, set breakpoints and watch variables, follow these steps.
Notes
- This adapter works with NUnit 3.0 and higher only. Use the NUnit 2 Adapter to run NUnit 2.x tests.
Announcements
- From version 3.9 the NUnit3TestAdapter will stop supporting Visual Studio 2012 RTM (!), note only RTM, the later updates will still be supported fully. If you're using VS 2012 and want to update NUnit3TestAdapter, please update your Visual Studio RTM to any of the subsequent updates (Update 1-5)
- From version 3.16 the NUnit3TestAdapter will stop supporting .net core 1
- From version 4.0 the NUnit3TestAdapter will only be released as a nuget package, the VSIX is deprecated.
- From version 5.0 the NUnit3TestAdapter will support MTP 1.X.
- From version 6.0 the NUnit3TestAdapter will support MTP 2.0, and stop supporting .net core 3. Lowest version will be .net 8.0.