NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet, #24 most downloaded on NuGet
Polly is a .NET resilience and transient-fault-handling library that allows developers to express resilience and transient fault handling policies such as Retry, Circuit Breaker, Timeout, Bulkhead Isolation, and Fallback in a fluent and thread-safe manner.
Latest stable
8.9.1
Last release 15 days ago
07 Nov 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
3 versions withdrawn
withdrawn after publishing
127 years old
83 releases · first in 1900
Drag across the ruler to compare, or tap a release to open it.
Improve synchronous async callback execution by @martincostello with @Copilot in #3313
Full Changelog: 8.9.0...8.9.1
Add net10.0 plus net8.0 for Polly by @martincostello in #3292
net10.0 plus net8.0 for Polly by @martincostello in #3292Full Changelog: 8.8.1...8.9.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Prevent the circuit breaker from capturing the ambient ExecutionContext by @Nacl-HCl in #3284
Full Changelog: 8.8.0...8.8.1
Add EnableReloadsWithMonitor() accepting custom IOptionsMonitor by @arashzjahangiri in #3140
EnableReloadsWithMonitor() accepting custom IOptionsMonitor by @arashzjahangiri in #3140FaultGenerator when no fault is generated by @dualfroz in #3220SOURCE_DATE_EPOCH by @martincostello in #3115NUGET_API_KEY by @martincostello in #3116PipelineExecutedArguments by @JiuYue0820 in #3201Full Changelog: 8.7.0...8.8.0
EnableReloadsWithMonitor() accepting custom IOptionsMonitor by @arashzjahangiri in https://github.com/App-vNext/Polly/pull/3140FaultGenerator when no fault is generated by @dualfroz in https://github.com/App-vNext/Polly/pull/3220Update deprecated action input by @martincostello in #3035
Full Changelog: 8.6.6...8.7.0
Fix ScheduledTaskExecutor deadlock when TrySetResult runs continuations inline by @crnhrv in #2953
Full Changelog: 8.6.5...8.6.6
Extend NuGet package validation by @martincostello in #2762
TimeoutRejectedException by @martincostello in #2827Full Changelog: 8.6.4...8.6.5
TimeoutRejectedException by @martincostello in https://github.com/App-vNext/Polly/pull/2827Fix after-release and update CHANGELOG by @martincostello in #2714
Full Changelog: 8.6.3...8.6.4
Add release notes configuration by @martincostello in #2678
Full Changelog: 8.6.2...8.6.3
Performance tweaks by @martincostello in #2667
Full Changelog: 8.6.1...8.6.2
Fix integer overflow in BulkheadSemaphoreFactory by @ahusseini in https://github.com/App-vNext/Polly/pull/2638
BulkheadSemaphoreFactory by @ahusseini in https://github.com/App-vNext/Polly/pull/2638Full Changelog: https://github.com/App-vNext/Polly/compare/8.6.0...8.6.1
Bump Stryker by @martincostello in https://github.com/App-vNext/Polly/pull/2476
AttemptNumber to HedgingPredicateArguments by @peter-csala in https://github.com/App-vNext/Polly/pull/2603OnRetryArguments comments by @lchaoer in https://github.com/App-vNext/Polly/pull/2627Full Changelog: https://github.com/App-vNext/Polly/compare/8.5.2...8.6.0
Fix build badges by @martincostello in https://github.com/App-vNext/Polly/pull/2445
Full Changelog: https://github.com/App-vNext/Polly/compare/8.5.1...8.5.2
Synchronize access to System.ComponentModel.DataAnnotations.Validator by @kmcclellan in https://github.com/App-vNext/Polly/pull/2428
System.ComponentModel.DataAnnotations.Validator by @kmcclellan in https://github.com/App-vNext/Polly/pull/2428Full Changelog: https://github.com/App-vNext/Polly/compare/8.5.0...8.5.1
Clean the Polly.Utils.ObjectPool class by @gabidabet in https://github.com/App-vNext/Polly/pull/2312
RetryAfter to BrokenCircuitException. by @DL444 in https://github.com/App-vNext/Polly/pull/2324[DebuggerDisableUserUnhandledExceptions] by @martincostello in https://github.com/App-vNext/Polly/pull/2003Full Changelog: https://github.com/App-vNext/Polly/compare/8.4.2...8.5.0
Update sponsors by @martincostello in https://github.com/App-vNext/Polly/pull/2169
Full Changelog: https://github.com/App-vNext/Polly/compare/8.4.1...8.4.2
Fix milestone closure by @martincostello in https://github.com/App-vNext/Polly/pull/2106
Full Changelog: https://github.com/App-vNext/Polly/compare/8.4.0...8.4.1
Remove async void usage by @martincostello in https://github.com/App-vNext/Polly/pull/2013
Full Changelog: https://github.com/App-vNext/Polly/compare/8.3.1...8.4.0
Add example for chaos engineering by @martintmk in https://github.com/App-vNext/Polly/pull/1956
Polly.Specs by @gintsk in https://github.com/App-vNext/Polly/pull/1974Full Changelog: https://github.com/App-vNext/Polly/compare/8.3.0...8.3.1
This release makes Simmy _chaos engineering_ strategies part of the Polly.Core package. 🐵🚀
This release makes Simmy chaos engineering strategies part of the Polly.Core package. 🐵🚀
FaultGenerator and OutcomeGenerator<T> by @martintmk in https://github.com/App-vNext/Polly/pull/1911Full Changelog: https://github.com/App-vNext/Polly/compare/8.2.1...8.3.0
Bump version to 8.2.1 by @martincostello in https://github.com/App-vNext/Polly/pull/1798
Full Changelog: https://github.com/App-vNext/Polly/compare/8.2.0...8.2.1
Prepare for 8.2.0 release by @martincostello in https://github.com/App-vNext/Polly/pull/1758
ConfigureTelemetry by @martintmk in https://github.com/App-vNext/Polly/pull/1787Full Changelog: https://github.com/App-vNext/Polly/compare/8.1.0...8.2.0
🐛 Fix issues that prevented the new Polly assemblies from the v8 release from being used in AoT scenarios - thanks to @davidfowl for reporting this is
ResilienceContextPool settable via DI from @cmeyertons (#1693)ResiliencePipelineProvider by @martintmk in https://github.com/App-vNext/Polly/pull/1662Full Changelog: https://github.com/App-vNext/Polly/compare/8.0.0...8.1.0
BenchmarkDotNet 0.13.2 by @SimonCropp in https://github.com/App-vNext/Polly/pull/972
Timeout overload by @prodehghan in https://github.com/App-vNext/Polly/pull/1109CircuitStateController and implement CircutBreakerResilienceStrategy by @martintmk in https://github.com/App-vNext/Polly/pull/1152BuilderName and StrategyName now defaults to null by @martintmk in https://github.com/App-vNext/Polly/pull/1251Polly.Strategy namespace by @martintmk in https://github.com/App-vNext/Polly/pull/1259src folder by @martintmk in https://github.com/App-vNext/Polly/pull/1289TelemetryResilienceStrategyOptions.ResultFormatter by @martintmk in https://github.com/App-vNext/Polly/pull/1294samples folder by @martintmk in https://github.com/App-vNext/Polly/pull/1295OnHedgingArguments by @martintmk in https://github.com/App-vNext/Polly/pull/1314TelemetryResilienceStrategyOptions to TelemetryOptions by @martintmk in https://github.com/App-vNext/Polly/pull/1318PredicateBuilder to delegates by @martintmk in https://github.com/App-vNext/Polly/pull/1332ResilienceContext.OperationKey by @martintmk in https://github.com/App-vNext/Polly/pull/1380PartitionedRateLimiter by @martintmk in https://github.com/App-vNext/Polly/pull/1383TelemetryOptions.OnTelemetryEvent by @martintmk in https://github.com/App-vNext/Polly/pull/1387ResilienceStrategyRegistry API improvements by @martintmk in https://github.com/App-vNext/Polly/pull/1388ResilienceStrategyBuilder.InstanceName and use it in telemetry by @martintmk in https://github.com/App-vNext/Polly/pull/1392Polly.Testing package by @martintmk in https://github.com/App-vNext/Polly/pull/1394BuilderName to Name by @martintmk in https://github.com/App-vNext/Polly/pull/1437Attempt to AttemptNumber by @martintmk in https://github.com/App-vNext/Polly/pull/1447CircuitBreakerStateProvider.LastHandledOutcome by @martintmk in https://github.com/App-vNext/Polly/pull/1446ResilienceStrategyBuilder to CompositeStrategyBuilder by @martintmk in https://github.com/App-vNext/Polly/pull/1448readonly modifier to private fields which are never changed by @Lehonti in https://github.com/App-vNext/Polly/pull/1451usings and the inversion of an if block. by @Lehonti in https://github.com/App-vNext/Polly/pull/1453MultipleStrategiesBenchmark by @martintmk in https://github.com/App-vNext/Polly/pull/1457ReactiveResilienceStrategy public by @martintmk in https://github.com/App-vNext/Polly/pull/1460ReactiveResilienceStrategy type-safe by @martintmk in https://github.com/App-vNext/Polly/pull/1462StrategyHelper for safe executions and drop redundant methods by @martintmk in https://github.com/App-vNext/Polly/pull/1463Extensions from Polly.Extensions namespace by @martintmk in https://github.com/App-vNext/Polly/pull/1469NonReactiveResilienceStrategy by @martintmk in https://github.com/App-vNext/Polly/pull/1476TelemetryResilienceStrategy by @martintmk in https://github.com/App-vNext/Polly/pull/1482ResiliencePipelineRegistry is now disposable by @martintmk in https://github.com/App-vNext/Polly/pull/1496Pipeline folder by @martintmk in https://github.com/App-vNext/Polly/pull/1497OutcomeArguments struct by @martintmk in https://github.com/App-vNext/Polly/pull/1513ResilienceProperties by @martintmk in https://github.com/App-vNext/Polly/pull/1524RetryStrategyOptions.MaxDelay property by @martintmk in https://github.com/App-vNext/Polly/pull/1620OnHedging event by @martintmk in https://github.com/App-vNext/Polly/pull/1625MaxDelay property by @martintmk in https://github.com/App-vNext/Polly/pull/1631AddHedging_IntegrationTest test by @martintmk in https://github.com/App-vNext/Polly/pull/1644Full Changelog: https://github.com/App-vNext/Polly/compare/7.2.4...8.0.0
Add RateLimit benchmarks by @martincostello in https://github.com/App-vNext/Polly/pull/910
Full Changelog: https://github.com/App-vNext/Polly/compare/7.2.3+24...7.2.4
Add RateLimit policy - Thanks to @reisenberger
Recursively search all AggregateException inner exceptions for predicate matches when using HandleInner() (#818) - Thanks to @sideproject
AggregateException inner exceptions for predicate matches when using HandleInner() (#818) - Thanks to @sideprojecttimeoutStrategy parameter was not being used by the TimeoutAsync(Func<TimeSpan>, TimeoutStrategy, Func<Context, TimeSpan, Task, Task>) method - Thanks to @martincostelloUpgrade SourceLink to RTM v1 (fixes building from source for latest .NET Core 3.1.x)
Add test target for netcoreapp3.0.
Remove deprecated cake add-in from build
Add SourceLink debugger support.
Bug fix for AdvancedCircuitBreakerAsync<TResult> (issue affecting v7.0.1-2 only)
Bug fix for PolicyRegistry (issue affecting v7.0.1 only)
Clarify separation of sync and async policies (breaking change)
Nothing published for this version
Nothing published for this version
Bug Fix: Async continuation control for async executions (issue 540, affected only v6.1.1)
Bug Fix: Context.PolicyKey behaviour in PolicyWrap (issue 510)
Bug Fix: Context.PolicyKey behaviour in PolicyWrap (issue 463)
Version 6 RTM, for integration to ASP.NET Core 2.1 IHttpClientFactory
Nothing published for this version
Per Semver, indicates deprecation of overloads and properties intended to be removed or renamed in Polly v6.
Add a new onBreak overload that provides the prior state on a transition to an open state
Add ability to calculate cache Ttl based on item to cache
Extend PolicyWrap syntax with interfaces
Add ability to handle inner exceptions natively: .HandleInner<TEx>()
Bug fix: non-generic CachePolicy with PolicyWrap
Matches the v5.4.0 release at the following nuget links:
Matches the v5.4.0 release at the following nuget links:
https://www.nuget.org/packages/polly/ https://www.nuget.org/packages/Polly-Signed/ https://www.nuget.org/packages/Polly.Net40Async/ https://www.nuget.org/packages/Polly.Net40Async-Signed/
Matches the v5.3.1 release at the following nuget links:
Matches the v5.3.1 release at the following nuget links:
https://www.nuget.org/packages/polly/ https://www.nuget.org/packages/Polly-Signed/ https://www.nuget.org/packages/Polly.Net40Async/ https://www.nuget.org/packages/Polly.Net40Async-Signed/
Matches the v5.3.0 release at the following nuget links:
Matches the v5.3.0 release at the following nuget links:
https://www.nuget.org/packages/polly/ https://www.nuget.org/packages/Polly-Signed/ https://www.nuget.org/packages/Polly.Net40Async/ https://www.nuget.org/packages/Polly.Net40Async-Signed/
Matches the v5.2.0 release at the following nuget links:
Matches the v5.2.0 release at the following nuget links:
https://www.nuget.org/packages/polly/ https://www.nuget.org/packages/Polly-Signed/ https://www.nuget.org/packages/Polly.Net40Async/ https://www.nuget.org/packages/Polly.Net40Async-Signed/
Nothing published for this version
Matches the v5.1.0 release at the following nuget links:
Matches the v5.1.0 release at the following nuget links:
https://www.nuget.org/packages/polly/ https://www.nuget.org/packages/Polly-Signed/ https://www.nuget.org/packages/Polly.Net40Async/ https://www.nuget.org/packages/Polly.Net40Async-Signed/
Nothing published for this version
Matches the v5.0.6 release at the following nuget links:
Matches the v5.0.6 release at the following nuget links:
https://www.nuget.org/packages/polly/ https://www.nuget.org/packages/Polly-Signed/ https://www.nuget.org/packages/Polly.Net40Async/ https://www.nuget.org/packages/Polly.Net40Async-Signed/
Matches the v5.0.5 release at the following nuget links:
Matches the v5.0.5 release at the following nuget links:
https://www.nuget.org/packages/polly/ https://www.nuget.org/packages/Polly-Signed/ https://www.nuget.org/packages/Polly.Net40Async/ https://www.nuget.org/packages/Polly.Net40Async-Signed/
We maintain change log documentation at: https://github.com/App-vNext/Polly/blob/master/CHANGELOG.md
We aim also to tag Issues fixed and PRs merged in each release, with milestones matching the release number. See, eg https://github.com/App-vNext/Polly/milestone/14?closed=1
LastException property return null rather than a fake exception.Minor breaking change: Where a user delegate does not observe cancellation, Polly will now honour the delegate's outcome rather than throw for the uno…
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.