GitHubActionsTestLogger 2.0.1

.NET Standard 2.0 .NET Framework 4.5.1
Install-Package GitHubActionsTestLogger -Version 2.0.1
dotnet add package GitHubActionsTestLogger --version 2.0.1
<PackageReference Include="GitHubActionsTestLogger" Version="2.0.1">
  <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add GitHubActionsTestLogger --version 2.0.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: GitHubActionsTestLogger, 2.0.1"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install GitHubActionsTestLogger as a Cake Addin
#addin nuget:?package=GitHubActionsTestLogger&version=2.0.1

// Install GitHubActionsTestLogger as a Cake Tool
#tool nuget:?package=GitHubActionsTestLogger&version=2.0.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

GitHub Actions Test Logger

Made in Ukraine Build Coverage Version Downloads Discord Donate Fuck Russia

🟒 Project status: active<sup>[?]</sup>

Custom logger for dotnet test that integrates with GitHub Actions. When using this logger, failed tests are listed in job annotations and highlighted in code diffs. Additionally, this logger also generates a job summary that contains detailed information about the executed test run.

Terms of use<sup>[?]</sup>

By using this project or its source code, for any purpose and in any shape or form, you grant your implicit agreement to all the following statements:

  • You condemn Russia and its military aggression against Ukraine
  • You recognize that Russia is an occupant that unlawfully invaded a sovereign state
  • You support Ukraine's territorial integrity, including its claims over temporarily occupied territories of Crimea and Donbas
  • You reject false narratives perpetuated by Russian state propaganda

To learn more about the war and how you can help, click here. Glory to Ukraine! πŸ‡ΊπŸ‡¦


  • πŸ“¦ NuGet: dotnet add package GitHubActionsTestLogger


annotations summary



To use GitHub Actions Test Logger, follow these steps:

  1. Install GitHubActionsTestLogger package in your test project
  2. Update Microsoft.NET.Test.Sdk package in your test project to the latest version
  3. Modify your GitHub Actions workflow file by adding --logger GitHubActions to dotnet test:
name: CI
on: [push, pull_request]

    runs-on: ubuntu-latest

      - name: Checkout
        uses: actions/checkout@v3

      - name: Install .NET
        uses: actions/setup-dotnet@v2
          dotnet-version: 6.0.x

      - name: Build & test
        run: dotnet test --configuration Release --logger GitHubActions

Warning: Ensure that your test project references Microsoft.NET.Test.Sdk version 17.2.0 or higher. Older versions of this package may not work properly with custom test loggers.

Warning: If you are using .NET SDK v2.2 or lower, you need to enable <CopyLocalLockFileAssemblies> property in your test project.


GitHub Actions Test Logger has options that you can override to customize its behavior. In order to pass an option to the logger, include it as an additional parameter inside --logger:

dotnet test --logger "GitHubActions;annotations.titleFormat=$test;annotations.messageFormat=$error"

Specifies the format of the annotation title used when reporting test failures.

The following replacement tokens are available:

  • $test β€” replaced with the display name of the test
  • $traits.TRAIT_NAME β€” replaced with the value of the trait named TRAIT_NAME
  • $error β€” replaced with the error message
  • $trace β€” replaced with the stack trace
  • $framework β€” replaced with the target framework

Default: $test.


  • $test β†’ MyTests.Test1
  • [$traits.Category] $test β†’ [UI Tests] MyTests.Test1
  • $test ($framework) β†’ MyTests.Test1 (.NETCoreApp,Version=v6.0)

Specifies the format of the annotation message used when reporting test failures. Supports the same replacement tokens as annotations.titleFormat.

Default: $error.


  • $error β†’ AssertionException: Expected 'true' but found 'false'
  • $error\n$trace β†’ AssertionException: Expected 'true' but found 'false', followed by stacktrace on the next line
Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net451 net452 net46 net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories (54)

Showing the top 5 popular GitHub repositories that depend on GitHubActionsTestLogger:

Repository Stars
Dapper - a simple object mapper for .Net
General purpose redis client
Quartz Enterprise Scheduler .NET
The stream database optimised for event sourcing
:angel: The ultimate angle brackets parser library parsing HTML5, MathML, SVG and CSS to construct a DOM based on the official W3C specifications.
Version Downloads Last updated
2.0.1 59,679 6/10/2022
2.0.0 23,237 5/29/2022
2.0.0-alpha 1,503 5/26/2022
1.4.1 50,963 4/19/2022
1.4.0 486 4/18/2022
1.3.0 85,437 2/21/2022
1.2.0 488,464 2/22/2021
1.1.2 82,413 10/26/2020
1.1.1 11,124 10/1/2020
1.1.0 127,578 4/27/2020
1.0.0 7,620 3/23/2020
0.0.1 931 3/22/2020