Configuring Job Queues

Hangfire can process multiple queues. If you want to prioritize your jobs or split the processing across your servers (some processes the archive queue, others – the images queue, etc), you can tell Hangfire about your decisions.

To place a job into a different queue, use the QueueAttribute class on your method:

public void SomeMethod() { }

BackgroundJob.Enqueue(() => SomeMethod());

Queue name argument formatting

The Queue name argument must consist of lowercase letters, digits, underscore, and dash (since 1.7.6) characters only.

To start to process multiple queues, you need to update your BackgroundJobServer configuration.

var options = new BackgroundJobServerOptions
    Queues = new[] { "critical", "default" }

// or
using (new BackgroundJobServer(options)) { /* ... */ }

The order is important, workers will fetch jobs from the critical queue first, and then from the default queue.


If you are using ASP.NET Core you can use the services.AddHangfireServer method in the Startup.cs file to define the queues array:

public void ConfigureServices(IServiceCollection services)
    // Add the processing server as IHostedService
    services.AddHangfireServer(options =>
        options.Queues = new[] { "critical", "default" };

Please use Hangfire Forum for long questions or questions with source code.