NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet, #306 most downloaded on NuGet
ASP.NET Core support for Hangfire, a background job framework for .NET applications.
Latest stable
1.8.25
Last release 2 months ago
28 Aug 2026
Ships fairly regularly
a new release about every 3 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
20 versions withdrawn
withdrawn after publishing
127 years old
113 releases · first in 1900
Drag across the ruler to compare, or tap a release to open it.
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfi
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfire-1.8.html to learn how to upgrade.
1.8.23
• Fixed – InvalidOperationException: The request reached the end of the pipeline without executing the endpoint.
1.8.22
• Added – MapHangfireDashboardWithNoAuthorizationFilters method, which does not include local-only filters.
• Changed – Set 404 status code when MapHangfireDashboard is used and no dispatcher is found.
• Fixed – InvalidOperationException upon receiving a request for 'hangfire/bootstrap.min.css.map'.
1.8.18
• Fixed – Swallow possible ObjectDisposedException in the StopAsync method.
• Fixed – Avoid NullReferenceException when LocalIpAddress or RemoteIpAddress is null.
1.8.10
• Fixed – Don't check HasStarted in Response.WriteAsync to avoid breaking dispatchers.
• Project – Enable NuGet package and DLL signing with a company certificate.
• Project – Require NuGet package signature validation on restore for dependencies.
• Project – Add HangfireIO as a package owner.
1.8.9 • Fixed – Don't attempt to write response headers when response has already started (by @maliming). • Project – Enable full source link support with embedded symbols and repository-based sources. • Project – Enable repeatable package restore using a lock file.
1.8.0
• Breaking – Make the package to be dependent on Hangfire.NetCore and use the same types.
• Added – IApplicationBuilder.UseHangfireServer that accepts custom factory for IBackgroundProcessingServer.
DisableConcurrentExecutionAttribute (#2581 by @net0well).SqlServerStorageOptions.DisableFetchSemaphores option to remove synchronization between workers (0b6ef50).Full Changelog: v1.8.24...v1.8.25
Your coding agent can read these notes before it upgrades. Set up the MCP server →
by @odinserj
August 28, 2026
release, hangfire-core
0 Comments
Edit on GitHub
Maintenance release with updated translations and added SqlServerStorageOptions.DisableFetchSemaphores option to remove synchronization between workers. Continue Reading →
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfi
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfire-1.8.html to learn how to upgrade.
1.8.23
• Fixed – InvalidOperationException: The request reached the end of the pipeline without executing the endpoint.
1.8.22
• Added – MapHangfireDashboardWithNoAuthorizationFilters method, which does not include local-only filters.
• Changed – Set 404 status code when MapHangfireDashboard is used and no dispatcher is found.
• Fixed – InvalidOperationException upon receiving a request for 'hangfire/bootstrap.min.css.map'.
1.8.18
• Fixed – Swallow possible ObjectDisposedException in the StopAsync method.
• Fixed – Avoid NullReferenceException when LocalIpAddress or RemoteIpAddress is null.
1.8.10
• Fixed – Don't check HasStarted in Response.WriteAsync to avoid breaking dispatchers.
• Project – Enable NuGet package and DLL signing with a company certificate.
• Project – Require NuGet package signature validation on restore for dependencies.
• Project – Add HangfireIO as a package owner.
1.8.9 • Fixed – Don't attempt to write response headers when response has already started (by @maliming). • Project – Enable full source link support with embedded symbols and repository-based sources. • Project – Enable repeatable package restore using a lock file.
1.8.0
• Breaking – Make the package to be dependent on Hangfire.NetCore and use the same types.
• Added – IApplicationBuilder.UseHangfireServer that accepts custom factory for IBackgroundProcessingServer.
by @odinserj
July 16, 2026
release, hangfire-core
0 Comments
Edit on GitHub
Patch release with added detection of blocked extension filter executions and Russian translation for Dashboard UI. Continue Reading →
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfi
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfire-1.8.html to learn how to upgrade.
1.8.23
• Fixed – InvalidOperationException: The request reached the end of the pipeline without executing the endpoint.
1.8.22
• Added – MapHangfireDashboardWithNoAuthorizationFilters method, which does not include local-only filters.
• Changed – Set 404 status code when MapHangfireDashboard is used and no dispatcher is found.
• Fixed – InvalidOperationException upon receiving a request for 'hangfire/bootstrap.min.css.map'.
1.8.18
• Fixed – Swallow possible ObjectDisposedException in the StopAsync method.
• Fixed – Avoid NullReferenceException when LocalIpAddress or RemoteIpAddress is null.
1.8.10
• Fixed – Don't check HasStarted in Response.WriteAsync to avoid breaking dispatchers.
• Project – Enable NuGet package and DLL signing with a company certificate.
• Project – Require NuGet package signature validation on restore for dependencies.
• Project – Add HangfireIO as a package owner.
1.8.9 • Fixed – Don't attempt to write response headers when response has already started (by @maliming). • Project – Enable full source link support with embedded symbols and repository-based sources. • Project – Enable repeatable package restore using a lock file.
1.8.0
• Breaking – Make the package to be dependent on Hangfire.NetCore and use the same types.
• Added – IApplicationBuilder.UseHangfireServer that accepts custom factory for IBackgroundProcessingServer.
AutomaticRetryAttribute is ignored under certain conditions regression from 1.8.14 (by @jirikanda).TypeNameAssemblyFormatHandling in tests with .NET 6 (by @viktor-vintertass).InvalidOperationException: The request reached the end of the pipeline without executing the endpoint.by @odinserj
February 5, 2026
release, news, hangfire-core
0 Comments
Edit on GitHub
This maintenance release fixes a regression appeared in Hangfire.Core 1.8.14 and related to possibly ignored extension filter registrations under some conditions due to unstable sorting, and contains a few other changes. Continue Reading →
All Posts
Release Notes
Hangfire Core
Hangfire Pro
Hangfire Ace
Security Announcements
Hangfire 1.8.25
Hangfire 1.8.24
Hangfire.Pro.Redis 3.3.2 & 2.11.2
Hangfire.Pro 3.0.5
Hangfire 1.8.23
Newsletters are Live Again
New Company, Hangfire OÜ
Dropping TLS 1.0 and 1.1 support
Unaffected by Codecov Breach
Introducing Hangfire.Throttling
Pricing Changes in 2017
12 reasons to use message queuing
Securing NuGet feed and discussion forum
Happy birthday, Hangfire!
Introducing Hangfire Pro
Are your methods ready to run in background?
Subscribe to receive monthly blog updates. Very low traffic, you can unsubscribe at any time.
Subscribe
I agree to be emailed
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfi
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfire-1.8.html to learn how to upgrade.
1.8.22
• Added – MapHangfireDashboardWithNoAuthorizationFilters method, which does not include local-only filters.
• Changed – Set 404 status code when MapHangfireDashboard is used and no dispatcher is found.
• Fixed – InvalidOperationException upon receiving a request for 'hangfire/bootstrap.min.css.map'.
1.8.18
• Fixed – Swallow possible ObjectDisposedException in the StopAsync method.
• Fixed – Avoid NullReferenceException when LocalIpAddress or RemoteIpAddress is null.
1.8.10
• Fixed – Don't check HasStarted in Response.WriteAsync to avoid breaking dispatchers.
• Project – Enable NuGet package and DLL signing with a company certificate.
• Project – Require NuGet package signature validation on restore for dependencies.
• Project – Add HangfireIO as a package owner.
1.8.9 • Fixed – Don't attempt to write response headers when response has already started (by @maliming). • Project – Enable full source link support with embedded symbols and repository-based sources. • Project – Enable repeatable package restore using a lock file.
1.8.0
• Breaking – Make the package to be dependent on Hangfire.NetCore and use the same types.
• Added – IApplicationBuilder.UseHangfireServer that accepts custom factory for IBackgroundProcessingServer.
IGlobalConfiguration.UseNoOpLogProvider method to disable logging.Cron class, add remarks in docs instead.SimpleAssemblyTypeSerializer.IBackgroundProcessingServer instances on OWIN app shutdown.AspNetShutdownDetector for early ASP.NET shutdown detection is not working (regression from 1.7.30).netcoreapp3.1 target with the net8.0 one in tests.InvalidCastException when creating a background job with Schema 5 (regression from 1.8.15).netcoreapp3.1 target with the net8.0 one in tests.MapHangfireDashboardWithNoAuthorizationFilters method, which does not include local-only filters.MapHangfireDashboard is used and no dispatcher is found.InvalidOperationException upon receiving a request for 'hangfire/bootstrap.min.css.map'.Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfi
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfire-1.8.html to learn how to upgrade.
1.8.18
• Fixed – Swallow possible ObjectDisposedException in the StopAsync method.
• Fixed – Avoid NullReferenceException when LocalIpAddress or RemoteIpAddress is null.
1.8.10
• Fixed – Don't check HasStarted in Response.WriteAsync to avoid breaking dispatchers.
• Project – Enable NuGet package and DLL signing with a company certificate.
• Project – Require NuGet package signature validation on restore for dependencies.
• Project – Add HangfireIO as a package owner.
1.8.9 • Fixed – Don't attempt to write response headers when response has already started (by @maliming). • Project – Enable full source link support with embedded symbols and repository-based sources. • Project – Enable repeatable package restore using a lock file.
1.8.0
• Breaking – Make the package to be dependent on Hangfire.NetCore and use the same types.
• Added – IApplicationBuilder.UseHangfireServer that accepts custom factory for IBackgroundProcessingServer.
FailedState.IncludeFileInfo to optionally show/hide line numbers in exceptions in Failed state.BackgroundJob class always acquires the most current JobStorage.Current instance.RecurringJob class always acquires the most current JobStorage.Current instance.SqlServerStorageOptions.DisableTransactionScope option for .NET Framework targets.Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfi
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfire-1.8.html to learn how to upgrade.
1.8.18
• Fixed – Swallow possible ObjectDisposedException in the StopAsync method.
• Fixed – Avoid NullReferenceException when LocalIpAddress or RemoteIpAddress is null.
1.8.10
• Fixed – Don't check HasStarted in Response.WriteAsync to avoid breaking dispatchers.
• Project – Enable NuGet package and DLL signing with a company certificate.
• Project – Require NuGet package signature validation on restore for dependencies.
• Project – Add HangfireIO as a package owner.
1.8.9 • Fixed – Don't attempt to write response headers when response has already started (by @maliming). • Project – Enable full source link support with embedded symbols and repository-based sources. • Project – Enable repeatable package restore using a lock file.
1.8.0
• Breaking – Make the package to be dependent on Hangfire.NetCore and use the same types.
• Added – IApplicationBuilder.UseHangfireServer that accepts custom factory for IBackgroundProcessingServer.
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfi
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfire-1.8.html to learn how to upgrade.
1.8.18
• Fixed – Swallow possible ObjectDisposedException in the StopAsync method.
• Fixed – Avoid NullReferenceException when LocalIpAddress or RemoteIpAddress is null.
1.8.10
• Fixed – Don't check HasStarted in Response.WriteAsync to avoid breaking dispatchers.
• Project – Enable NuGet package and DLL signing with a company certificate.
• Project – Require NuGet package signature validation on restore for dependencies.
• Project – Add HangfireIO as a package owner.
1.8.9 • Fixed – Don't attempt to write response headers when response has already started (by @maliming). • Project – Enable full source link support with embedded symbols and repository-based sources. • Project – Enable repeatable package restore using a lock file.
1.8.0
• Breaking – Make the package to be dependent on Hangfire.NetCore and use the same types.
• Added – IApplicationBuilder.UseHangfireServer that accepts custom factory for IBackgroundProcessingServer.
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfi
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfire-1.8.html to learn how to upgrade.
1.8.18
• Fixed – Swallow possible ObjectDisposedException in the StopAsync method.
• Fixed – Avoid NullReferenceException when LocalIpAddress or RemoteIpAddress is null.
1.8.10
• Fixed – Don't check HasStarted in Response.WriteAsync to avoid breaking dispatchers.
• Project – Enable NuGet package and DLL signing with a company certificate.
• Project – Require NuGet package signature validation on restore for dependencies.
• Project – Add HangfireIO as a package owner.
1.8.9 • Fixed – Don't attempt to write response headers when response has already started (by @maliming). • Project – Enable full source link support with embedded symbols and repository-based sources. • Project – Enable repeatable package restore using a lock file.
1.8.0
• Breaking – Make the package to be dependent on Hangfire.NetCore and use the same types.
• Added – IApplicationBuilder.UseHangfireServer that accepts custom factory for IBackgroundProcessingServer.
DashboardOptions.ServerPossiblyAbortedThreshold to configure a custom threshold for "possibly aborted" warnings.CultureInfo-related differences after upgrading to 1.8.15–1.8.17.AsyncLocal values from synchronous background job methods.Job.Args property to the Job class' constructor.cshtml files working on newer platforms.ObjectDisposedException in the StopAsync method.NullReferenceException when LocalIpAddress or RemoteIpAddress is null.Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfi
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfire-1.8.html to learn how to upgrade.
1.8.10
• Fixed – Don't check HasStarted in Response.WriteAsync to avoid breaking dispatchers.
• Project – Enable NuGet package and DLL signing with a company certificate.
• Project – Require NuGet package signature validation on restore for dependencies.
• Project – Add HangfireIO as a package owner.
1.8.9 • Fixed – Don't attempt to write response headers when response has already started (by @maliming). • Project – Enable full source link support with embedded symbols and repository-based sources. • Project – Enable repeatable package restore using a lock file.
1.8.0
• Breaking – Make the package to be dependent on Hangfire.NetCore and use the same types.
• Added – IApplicationBuilder.UseHangfireServer that accepts custom factory for IBackgroundProcessingServer.
InvalidCastException while fetching a job with older schemas regression from 1.8.16.Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfi
Release notes are available in our blog https://www.hangfire.io/blog/ Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfire-1.8.html to learn how to upgrade.
1.8.10
• Fixed – Don't check HasStarted in Response.WriteAsync to avoid breaking dispatchers.
• Project – Enable NuGet package and DLL signing with a company certificate.
• Project – Require NuGet package signature validation on restore for dependencies.
• Project – Add HangfireIO as a package owner.
1.8.9 • Fixed – Don't attempt to write response headers when response has already started (by @maliming). • Project – Enable full source link support with embedded symbols and repository-based sources. • Project – Enable repeatable package restore using a lock file.
1.8.0
• Breaking – Make the package to be dependent on Hangfire.NetCore and use the same types.
• Added – IApplicationBuilder.UseHangfireServer that accepts custom factory for IBackgroundProcessingServer.
IServerFilter implementations.ExceptionDetails property of a FailedState instance.CancellationEvent usage instead of CancellationToken.WaitHandle.BackgroundJobStateChanger implementation.net451 platform when using .NET 9.0.RecurringJobSchedulerFacts class.Microsoft.CodeAnalysis.NetAnalyzers package to version 9.0.0.SqlServerJobQueue implementation.LockTimeout time when calling the sp_getapplock procedure to 1 second for less blocking.net6.0 platform.PoolBlockingPeriod setting on AppVeyor to handle transient test failures.Added – New AutomaticRetryAttribute.ExceptOn property to skip retries for specific exceptions.
AutomaticRetryAttribute.ExceptOn property to skip retries for specific exceptions.GetCultureInfo instead of creating an instance in the CaptureCultureAttribute filter.build.bat command.string allocations.QuerySingle* or ReadSingle* where possible to avoid allocating lists.DbCommand and DbParameter creation logic to improve code consistency.Changed – Partial cache for serialization and deserialization in InvocationData to produce less strings.
InvocationData to produce less strings.JobFilter-related logic to show up in profilers.IProfiler to be less allocatey for diagnostic purposes that almost never run.CancellationToken.WaitHandle again, since early .NET Core days are gone.IStateHandler collections in a state machine.KeyNotFoundException when recurring job is malformed.UrlHelper.To for OWIN-based Dashboard UI (by @LordJZ).Nothing published for this version
Added – MaxDegreeOfParallelismForSchedulers experimental server option if supported by storage.
MaxDegreeOfParallelismForSchedulers experimental server option if supported by storage.AddOrUpdate.AddOrUpdate triggers execution of a recurring job, even if its next execution is in the future.InvocationData and LoadException properties in JobDetails method results.Changed – Add icons and fix metadata for NuGet packages.
Changed – Added Norwegian translations for new keys (by @khellang).
HasStarted in Response.WriteAsync to avoid breaking dispatchers.netstandard2.0 platform to version 2.1.28.net451 and netstandard1.3 platforms to version 1.60.6.HangfireIO as a package owner.Please note that version 1.8.8 was unlisted on NuGet because of broken package references.
Please note that version 1.8.8 was unlisted on NuGet because of broken package references.
Environment.MachineName as a server name if other environment vars aren't available.NullReferenceException on the Deleted Jobs page (regression from 1.8.7).net6.0 platform.net6.0 platform.Nothing published for this version
Added – Allow using macro expressions like @hourly for recurring jobs (by @MuhamedAbdalla).
@hourly for recurring jobs (by @MuhamedAbdalla).NullReferenceException from the Scheduled Jobs page when there's a job with missing data.NullReferenceException from the Processing Jobs page when there's a job with missing data.netcoreapp1.0 and netcoreapp2.1 targets since they aren't supported in AppVeyor.net6.0 target for unit tests instead of the removed ones.netcoreapp1.0 and netcoreapp2.1 targets since they aren't supported in AppVeyor.net6.0 target for unit tests instead of the removed ones.Changed – Update jQuery library in Dashboard UI to version 3.7.1.
EditorBrowsableAttribute(Never).AutomaticRetryAttribute class from JSON.CurrentCulture instead of CurrentUICulture when displaying time.DbCommand resource leak when releasing a lock detected by static analysis.Added – Possibility to inform a FaviconPath on DashboardOptions (by @cezar-pimentel).
FaviconPath on DashboardOptions (by @cezar-pimentel).AutomaticRetryAttribute filter to JSON.Schema 5.Added – Pass server id from a worker to the PerformContext.ServerId property available in filters.
PerformContext.ServerId property available in filters.ObjectDisposedException.IHostedService implementations can block Hangfire server from being stopped.Changed – Allow to configure MaxLinesInStackTrace for a particular FailedState instance.
Hangfire.Core
MaxLinesInStackTrace for a particular FailedState instance.DisableConcurrentExecutionAttribute and LatencyTimeoutAttribute serializable.Changed – Disable transactional job creation feature appeared in 1.8.0.
Hangfire.Core
Hangfire.SqlServer
InvalidOperationException with new dashboard metrics when a database has multiple data/log files.Added – MisfireHandlingMode.Ignorable to avoid scheduling recurring jobs on missed schedules.
Hangfire.Core
MisfireHandlingMode.Ignorable to avoid scheduling recurring jobs on missed schedules.DashboardOptions.DarkModeEnabled property.WithJobExpirationTimeout configuration method.UseDefaultCulture configuration method overloads.UseDashboardStylesheet and UseJobDetailsRenderer configuration methods.state-card-state-active color is not very dark (by @coolhome).Hangfire.SqlServer
forceseek table hint whenever possible to avoid performance drops.Hangfire.NetCore
net461 target for Hangfire.NetCore package to avoid missing method exceptions.Deprecated – AddOrUpdate overloads with optional params defined in the RecurringJobManagerExtensions class.
Please see more human-friendly release notes in our blog https://www.hangfire.io/blog/2023/04/28/hangfire-1.8.0.html. Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfire-1.8.html to learn how to upgrade.
Hangfire.Core
NET45 platform target in favor of the NET451 target to support Visual Studio 2022.Job.Queue property, so jobs now can have their own queue specified.IBackgroundJobClient.Create method overloads with the new queue parameter.AutomaticRetryAttribute by using the new OnlyOn property.DeletedState now has the persisted Exception property populated after a failure.JobContinuationOptions.OnlyOnDeletedState to create continuations after a failure.Exception job parameter is passed to continuation when UseResultsInContinuations method is used.FromExceptionAttribute to deal with an antecedent exception in a background job continuation.JobContinuationOptions values for a continuation.BackgroundJobServerOptions.IsLightweightServer option to run a server with no storage processes.DisableConcurrentExecution filter.ServerId to FailedState instances to simplify the debugging on different servers.MisfireHandlingMode.Strict to create a job for each missed recurring job occurrence.UseDefaultCulture configuration method.captureDefault parameter in the CaptureCulture filter.IGlobalConfiguration.UseFilterProvider extension method to unify the configuration.Remove method for JobFilterCollection to remove global filters based on their type.CompatibilityLevel.Version_180 flag to avoid storing culture parameters when they are the same as the default ones.Transaction.CreateJob feature is supported by the storage.DeletedState instead of SucceededState when its invocation was canceled by a filter.CurrentCulture parameter when CurrentUICulture one is missing.BackgroundJobServerOptions.StopTimeout to 500 ms.AddOrUpdate overloads with optional params defined in the RecurringJobManagerExtensions class.AddOrUpdate overloads with optional parameters defined in the RecurringJob class.AddOrUpdate method overloads with no recurringJobId parameter.RecurringJobOptions.QueueName property, new methods should be used instead.NET45 platform target in favor of NET451 target to support Visual Studio 2022.Dashboard UI
DashboardRoutes class.DefaultRecordsPerPage property on the DashboardOptions class (by @PaulARoy).IGlobalConfiguration.UseJobDetailsRenderer method for custom renderers for the Job Details page.IGlobalConfiguration.UseDashboardMetrics extension method to pass multiple metrics at once.DeletedState to display its new exception property.MonitoringApi methods for the Awaiting Jobs page.default one.Extensibility
Factory, StateMachine, and Performer properties to context classes to avoid injecting services.ApplyStateContext and ElectStateContext instances.JobFilterAttribute instance to decrease the payload size.Storage
JobStorage.GetReadOnlyConnection method intended to return JobStorageConnection for replicas.JobStorage.HasFeature method for querying optional features.JobStorageFeatures class to avoid using magic strings in storage features.GetSetCount, GetSetContains, and GetUtcDateTime methods for the JobStorageConnection class.AcquireDistributedLock and RemoveFromQueue methods for the JobStorageTransaction class.CreateJob and SetJobParameter methods for the JobStorageTransaction class.ParametersSnapshot property for BackgroundJob and JobData classes to minimize roundtrips in the future.Retries and Awaiting metrics in StatisticsDto properties when supported by storage.JobStorageMonitor class with more available methods for the new features.Monitoring.AwaitingJobs feature.Internals
IBackgroundProcess.UseBackgroundPool now allows to pass thread configuration logic.BackgroundJobServerOptions.WorkerThreadConfigurationAction option for custom thread configuration.FromParameterAttribute-based logic now always overwrites arguments, even with non-null values.JobContinuationOptions enum into flags while still possible.TaskExtensions.WaitOneAsync only with the RegisterWaitForSingleObject method.ServerHeartbeatProcess now uses ThreadPriority.AboveNormal to prioritize heartbeats.Hangfire.NetCore
IApplicationBuilder.UseHangfireServer that accepts custom factory for IBackgroundProcessingServer.net451 and netstandard1.3 targets for the package.netstandard2.1 target instead of netcoreapp3.0 for the package.ObjectDisposedException when hosted service is disposed twice.Hangfire.AspNetCore
IApplicationBuilder.UseHangfireServer that accepts custom factory for IBackgroundProcessingServer.Hangfire.SqlServer
NET45 platform target in favor of the NET451 target to support Visual Studio 2022.Schema 8 migration with fixed JobQueue.Id column to use the bigint type.Schema 9 migration that creates an index for the State.CreatedAt column.System.Data.SqlClient (by @0xced).SqlServerStorageOptions.DbProviderFactory option to use a custom provider factory.InactiveStateExpirationTimeout is set.TryAutoDetectSchemaDependentOptions option to automatically enable options based on the schema.UseTransactionalAcknowledge option).Connection.GetUtcDateTime feature to make work the new changes in schedulers.SqlServerStorage.SchemaVersion metric for Dashboard UI.DefaultQueueProvider option to specify a custom default queue provider.QueuePollInterval option to TimeSpan.Zero.QueuePollInterval is set to zero now defaults to 200 ms.UseRecommendedIsolationLevel option by default.GetJobData now populates the JobData.ParametersSnapshot property to avoid additional roundtrips.Transaction.AcquireDistributedLock feature.GetSetCount.Limited feature.GetSetContains feature.Monitoring.AwaitingJobs feature for SQL storage.UsePageLocksOnDequeue option is now obsolete and doesn't affect anything.Hangfire.SqlServer.Msmq
NET45 platform target in favor of the NET451 target to support Visual Studio 2022.Added – DefaultRecordsPerPage property on the DashboardOptions class (by @PaulARoy).
Hangfire.Core
DefaultRecordsPerPage property on the DashboardOptions class (by @PaulARoy).Hangfire.NetCore
ObjectDisposedException when hosted service disposed twice.Hangfire.SqlServer
Schema 9 migration that creates index for the State.CreatedAt column.InactiveStateExpirationTimeout is set.DefaultQueueProvider option to specify a custom default queue provider.Please see release notes in our blog – https://www.hangfire.io/blog/2023/03/30/hangfire-1.8.0-rc3.html.
Please see release notes in our blog – https://www.hangfire.io/blog/2023/03/30/hangfire-1.8.0-rc3.html.
captureDefault parameter in the CaptureCulture filter.StatisticsDto.Awaiting for monitoring stats.JobStorageFeatures class to avoid using magic strings in storage features.captureDefault when dealing with default cultures instead of compatibility level.SetContains to GetSetContains for consistency.Monitoring.AwaitingJobs feature.BatchedGetFirstByLowest feature.NotSupportedException from new storage methodsJobStorageMonitor virtual, not abstract.Job.Queue feature not supported.AttemptsExceededAction.Delete option by default in the global automatic retry filter.Monitoring.AwaitingJobs feature for SQL storage.Transaction.AcquireDistributedLock feature.GetSetCount.Limited feature.GetSetContains feature.Added – Support for default culture and UI culture via the UseDefaultCulture configuration method.
UseDefaultCulture configuration method.CompatibilityLevel.Version_180 flag to avoid storing culture parameters when they are the same as default.BackgroundJobServerOptions.IsLightweightServer option to run server with no storage processes.CurrentCulture parameter when CurrentUICulture one is missing.net451 and netstandard1.3 targets for the package.netstandard2.1 target instead of netcoreapp3.0 for the package.Deprecated – AddOrUpdate overloads with optional params defined in the RecurringJobManagerExtensions class.
Job.Queue property, so jobs now can have their own queue specified.IBackgroundJobClient.Create method overloads with the new queue parameter.JobContinuationOptions.OnlyOnDeletedState to create continuations after a failure.JobContinuationOptions values for a continuation.DisableConcurrentExecution filter.ServerId to FailedState instances to simplify the debugging on different servers.MisfireHandlingMode.Strict to create job for each missed recurring job occurrence.DeletedState now have the persisted Exception property populated after a failure.Exception job parameter is passed to continuation when UseResultsInContinuations method is used.FromExceptionAttribute to deal with an antecedent exception in a background job continuation.AutomaticRetryAttribute by using the new OnlyOn property.Remove method for JobFilterCollection to remove global filters based on their type.IGlobalConfiguration.UseFilterProvider extension method to unify the configuration.AttemptsExceededAction.Delete option by default in the global automatic retry filter.BackgroundJobServerOptions.StopTimeout to 500 ms.DeletedState instead of SucceededState when its invocation was canceled by a filter.AddOrUpdate overloads with optional params defined in the RecurringJobManagerExtensions class.AddOrUpdate overloads with optional parameters defined in the RecurringJob class.AddOrUpdate method overloads with no recurringJobId parameter.RecurringJobOptions.QueueName property, new methods should be used instead.NET45 platform target in favor of NET451 target to support Visual Studio 2022.Dashboard UI
UseDarkModeSupportForDashboard method (by @danillewin).DashboardRoutes class.IGlobalConfiguration.UseJobDetailsRenderer method for custom renderers for Job Details page.IGlobalConfiguration.UseDashboardMetrics extension method to pass multiple metrics at once.DeletedState to display its new exception property.default one.Extensibility
Factory, StateMachine and Performer properties to context classes to avoid injecting services.ApplyStateContext and ElectStateContext instances.JobFilterAttribute instance to decrease payload size.Storage
JobStorage.GetReadOnlyConnection method intended to return JobStorageConnection for replicas.JobStorage.HasFeature method for querying optional features.GetSetCount and GetUtcDateTime methods for the JobStorageConnection class.AcquireDistributedLock and RemoveFromQueue methods for the JobStorageTransaction class.CreateJob method to the JobStorageTransaction abstract class.SetJobParameter method to the JobStorageTransaction abstract class.JobStorageConnection.SetContains method.ParametersSnapshot property for BackgroundJob and JobData classes to minimize roundtrips in future.JobStorageMonitor class with more available methods for the new features.Internals
IBackgroundProcess.UseBackgroundPool now allows to pass thread configuration logic.BackgroundJobServerOptions.WorkerThreadConfigurationAction option for custom thread configuration.FromParameterAttribute-based logic now always overwrites arguments, even with non-null values.JobContinuationOptions enum into flags while still possible.TaskExtensions.WaitOneAsync only with the RegisterWaitForSingleObject method.ServerHeartbeatProcess now uses ThreadPriority.AboveNormal to prioritize heartbeats.JobQueue.Id column to use the bigint type.System.Data.SqlClient (by @0xced).SqlServerStorageOptions.DbProviderFactory option to use custom provider factory.TryAutoDetectSchemaDependentOptions option to automatically enable options based on schema.SqlServerStorage.SchemaVersion metric for Dashboard UI.UseTransactionalAcknowledge option).Connection.GetUtcDateTime feature to make work new changes in schedulers.QueuePollInterval option to TimeSpan.Zero.QueuePollInterval is set to zero now defaults to 200 ms.UseRecommendedIsolationLevel option by default.GetJobData now populates JobData.ParametersSnapshot property to avoid additional round-trips.UsePageLocksOnDequeue option is now obsolete and doesn't affect anything.NET45 platform target in favor of NET451 target to support Visual Studio 2022.NET45 platform target in favor of NET451 target to support Visual Studio 2022.IApplicationBuilder.UseHangfireServer that accepts custom factory for IBackgroundProcessingServer.Deprecated – UsePageLocksOnDequeue option is now obsolete and doesn't affect anything.
UseDarkModeSupportForDashboard method.DashboardRoutes class.DisableConcurrentExecutionAttribute.BackgroundJobServerOptions.StopTimeout to 500 ms.TryAutoDetectSchemaDependentOptions option to automatically enable options based on schema.GetJobData now populates JobData.ParametersSnapshot property to avoid additional round-trips.QueuePollInterval is set to zero now defaults to 200 ms.UsePageLocksOnDequeue option is now obsolete and doesn't affect anything.Deprecated – AddOrUpdate overloads with optional params defined in the RecurringJobManagerExtensions class.
Hangfire.Core
Job.Queue property, so jobs now can have their own queue specified.IBackgroundJobClient.Create method overloads with the new queue parameter.JobStorageConnection.SetContains method.ServerId to FailedState instances to simplify the debugging on different servers.default one.TaskExtensions.WaitOneAsync only with the RegisterWaitForSingleObject method.null value before passing it to renderers (regression).AddOrUpdate overloads with optional params defined in the RecurringJobManagerExtensions class.AddOrUpdate overloads with optional parameters defined in the RecurringJob class.AddOrUpdate method overloads with no recurringJobId parameter.RecurringJobOptions.QueueName property, new methods should be used instead.Hangfire.SqlServer
Connection.GetUtcDateTime feature to make work new changes in schedulers.Added – MisfireHandlingMode.Strict to create job for each missed recurring job occurrence.
Hangfire.Core
MisfireHandlingMode.Strict to create job for each missed recurring job occurrence.JobContinuationOptions for a continuation.CreateJob method to the JobStorageTransaction abstract class.SetJobParameter method to the JobStorageTransaction abstract class.JobContinuationOptions enum into flags while still possible.FromParameter attribute.OnlyOnDeletedState option.Hangfire.SqlServer
QueuePollInterval option to TimeSpan.Zero.UseRecommendedIsolationLevel option by default.Added – Display deleted jobs in the Realtime and History graphs when supported by storage.
Hangfire.Core
DeletedState now have the persisted Exception property.JobContinuationOptions.OnlyOnDeletedState to create continuations after a failure.Exception job parameter is passed to continuation when UseResultsInContinuations method is used.FromExceptionAttribute to deal with an antecedent exception in a background job continuation.AutomaticRetryAttribute by using the new OnlyOn property.IBackgroundProcess.UseBackgroundPool now allows to pass thread configuration logic.IGlobalConfiguration.UseJobDetailsRenderer method for custom renderers.BackgroundJobServerOptions.WorkerThreadConfigurationAction optionApplyStateContext and ElectStateContext instances.IGlobalConfiguration.UseDashboardMetrics extension method to pass multiple metrics at once.DeletedState to display its new exception property.JobStorage.GetReadOnlyConnection method intended to return JobStorageConnection for replicas.JobStorage.HasFeature method for querying optional features.GetSetCount and GetUtcDateTime methods for the JobStorageConnection class.AcquireDistributedLock and RemoveFromQueue methods for the JobStorageTransaction class.Factory, StateMachine and Performer properties to context classes to avoid injecting services.ParametersSnapshot property for BackgroundJob and JobData classes to minimize roundtrips in future.AttemptsExceededAction.Delete option by default in the global automatic retry filter.DeletedState instead of SucceededState when its invocation was canceled by a filter.FromParameterAttribute-based logic now always overwrites arguments, even with non-null values.JobFilterAttribute instance to decrease sizeServerHeartbeatProcess now uses ThreadPriority.AboveNormal to prioritize heartbeats.Hangfire.SqlServer
JobQueue.Id column to use bigint type.SqlServerStorageOptions.PreferMicrosoftDataSqlClient option to use the corresponding package.SqlServerStorage.SchemaVersion metric for Dashboard UI.UseTransactionalAcknowledge option).Hangfire.NetCore and Hangfire.AspNetCore
IApplicationBuilder.UseHangfireServer that accepts custom factory for IBackgroundProcessingServer.Fixed – Recurring job is scheduled to the past after recovering from error with AddOrUpdate (backported).
AddOrUpdate (backported).AddOrUpdate triggers execution of a recurring job, even if its next execution is in the future (backported).Fixed – Remove job id from schedule when it's not in the Scheduled state for some reason.
Hangfire.Core
Hangfire.NetCore and Hangfire.AspNetCore
null in hosted service to avoid ObjectDisposedException.Fixed – Blocked workers regression since 1.7.28 when using multiple servers inside a process.
Hangfire.SqlServer
Added – Add reschedule functionality to BackgroundJob and IBackgroundJobClient (by @chrischu).
BackgroundJob and IBackgroundJobClient (by @chrischu).ArgumentNullException with tricky generic type with inheritance case for jobs.Changed – Use SQL Server as a time authority for server heartbeats.
MinPollingDelayMs for SQL Server to 100 milliseconds.IAsyncDisposable for IServiceScope instances for newer .NET platforms.Added – First version of Swedish translation of the Dashboard UI (by @karl-sjogren).
JobStorage.Current is not initialized.TypeHelperSerializationBinder class public to use it from custom serializer settings.IJobCancellationToken interface method (by @judah4).AddHangfireServer.null as result of StopAsync in hosted service implementation (by @tomaszek92).Deprecated – RecurringJob.Trigger method is now obsolete, TriggerJob is the replacement.
RecurringJob.TriggerJob method that returns identifier of a triggered background job.RecurringJobManager.TriggerJob as a replacement for the TriggerExecution method.RecurringJob class.RecurringJob.Trigger method is now obsolete, TriggerJob is the replacement.RecurringJobManager.TriggerExecution method is now obsolete, TriggerJob should be used instead.Full Changelog: https://github.com/HangfireIO/Hangfire/compare/v1.7.30...v1.7.31
Fixed – Don't consider SecurityException as a non-catchable one.
SecurityException as a non-catchable one.AspNetShutdownDetector to avoid depending on thread pool.AspNetShutdownDetector's check intervals to detect shutdowns earlier.Added – RecurringJobManager.TriggerExecution method that returns identifier of a created job.
RecurringJobManager.TriggerExecution method that returns identifier of a created job.GetRecurringJobIds extension method for JobStorageConnection that returns only identifiers.DashboardMetric.Url property to make it possible for metrics on the Overview page to be clickable (by @twinmind).DateOnly and TimeOnly in .NET 6.0 or other new types in CoreLib.OutOfMemoryException or StackOverflowException.ManualResetEvent instance in BackgroundExecution.Fixed – Reduce the number of attempts in BackgroundJobStateChanger to avoid infinite loops.
Hangfire.Core
BackgroundJobStateChanger to avoid infinite loops.Hangfire.SqlServer
Added – Turkish language support for the Dashboard UI (by @csarigul).
CVE ID CVE-2021-41238 Affected Packages Hangfire.Core = 1.7.25 (only) Affected Platforms All, including .NET Core, .NET Framework, Mono of any version
This security patch fixes a regression appeared in the previous version 1.7.25 that makes Dashboard UI available for remote requests in the default configuration, e.g. when no authentication filter specified. Please note that when custom authentication filter is defined as recommended in the documentation, everything works as expected, but upgrade is recommended in any case. Please read the GHSA-7rq6-7gv8-c37h security advisory for details.
<dl> <dt>CVE ID</dt><dd>CVE-2021-41238</dd> <dt>Affected Packages</dt><dd>Hangfire.Core = 1.7.25 (only)</dd> <dt>Affected Platforms</dt><dd>All, including .NET Core, .NET Framework, Mono of any version</dd> </dl>
Hangfire.Core
Deprecated – UseHangfireServer method for targets where AddHangfireServer one is available.
Hangfire.Core
HeartbeatInterval option (by @GitHubPang).Hangfire.SqlServer
Server table.Hangfire.NetCore and Hangfire.AspNetCore
AddHangfireServer extension method in .NET Core.UseHangfireServer method for targets where AddHangfireServer one is available.Added – Support for async auth methods via the DashboardOptions.AsyncAuthorization property (#1803 by @rosenbjerg).
Hangfire.Core
DashboardOptions.AsyncAuthorization property (#1803 by @rosenbjerg).AppBuilderExtensions class (#1878 by @LordJZ).TypeHelper class public instead of internal to use it outside.Hangfire.SqlServer
readcommittedlock table hint when not required.TransactionScope class in tests, re-create database instead.Hangfire.AspNetCore
DashboardOptions.AsyncAuthorization property (#1803 by @rosenbjerg).MapHangfireDashboardWithAuthorizationPolicy method (#1663 by @dasiths).Project – Replace deprecated PerformContext ctor usage to avoid alerts in SonarQube (by @kumaheiyama).
Hangfire.Core
JobId property to JobPerformanceException for error logging purposes (by @Plasma).JsonSerializationException when using IdempotentCompletionAttribute.DeserializePayload method.PerformContext ctor usage to avoid alerts in SonarQube (by @kumaheiyama).NullReferenceException in tests to fix alerts in Fortify analyser.Hangfire.SqlServer
NotImplementedException in Transaction.EnlistPromotableSinglePhase when running on Mono.Fixed – Fonts-related regression in Dashboard UI after upgrading Bootstrap in 1.7.21.
Hangfire.Core
Changed – Upgrade jQuery from 2.1.4 to 2.2.4 in Dashboard UI.
Hangfire.Core
Hangfire.SqlServer
DisableConcurrentExecution for long-running jobs.Please see https://www.hangfire.io/blog/2021/03/19/hangfire-1.7.20.html for details, manual changes required to fix potential problems when using Hang
Please see https://www.hangfire.io/blog/2021/03/19/hangfire-1.7.20.html for details, manual changes required to fix potential problems when using Hangfire.SqlServer as a job storage for those who already migrated to Schema 6 and 7. This problem will be also fixed in a new migration in Hangfire 1.8.0.
Hangfire.Core
Hangfire.SqlServer
Schema 6 migration now fixes problem that prevents 2,147,483,648th job from being enqueued.Hangfire.NetCore and Hangfire.AspNetCore
AddHangfireServer utilizing IServiceProvider (PR #1800 by @penenkel).IBackgroundJobClientFactory and IRecurringJobManagerFactory interfaces to fix the following bug.JobStorage.Added – German (Deutsch) Dashboard UI localization (PR #1772 by @d-oit).
Hangfire.Core
IGlobalConfiguration.UseMaxArgumentSizeToRender method to avoid "VALUE TOO BIG" messages.JobMethodCallRenderer.MaxArgumentToRenderSize field to support .NET 5.0.AspNetShutdownDetector leads to NullReferenceException (PR #1786 by @jr01).Hangfire.SqlServer
null instead of throwing FormatException when job id can't be parsed.Added – SqlServerStorageOptions.DeleteExpiredBatchSize option to remove more expired records in a single pass.
Hangfire.SqlServer
SqlServerStorageOptions.DeleteExpiredBatchSize option to remove more expired records in a single pass.SqlServerStorage.ToString method when using custom factory or existing connection.Fixed – SqlException "Incorrect syntax near 'throw'" after upgrading to 1.7.15 when using SQL Server 2008 or 2008R2.
Hangfire.SqlServer
Fixed – Blocking problems when using multiple storages with the same queue names in the same process (appeared in 1.7.9).
Hangfire.SqlServer
Added – IGlobalConfiguration.UseMaxLinesInExceptionDetails option to cap the size of stack traces.
Hangfire.Core
IGlobalConfiguration.UseMaxLinesInExceptionDetails option to cap the size of stack traces.Hangfire.SqlServer
SetJobParameter method without introducing issues for older schemas.SqlServerMonitoringApi.GetJobs method which is used by a lot of queries.Changed – Use better queries for jobs with 3 and 4 parameters, this is a common case.
Hangfire.SqlServer
JobParameters table after upgrading to version 1.7.13.SqlServerMonitoringApi.Added – Catalan translation for Dashboard UI (based on Spanish translation, by @agausachs).
Hangfire.Core
Hangfire.SqlServer
UseIgnoreDupKeyOption for SQL Server storage configuration (changes to [Set] and [Hash] tables required).SqlServerWriteOnlyTransaction class.holdlock hint to xlock in merge statements in transaction to prevent deadlocks.Added – Display actual job payload and exception message on job details page when could find the method.
One column per quarter.