Queue::forward(): Reroute Laravel Queues in One Place | Mohamed Said [ ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MH.png) Mohamed Said Laravel Backend Engineer ](https://msaied.com) [ Home ](https://msaied.com) [ Projects ](https://msaied.com/projects) [ Articles ](https://msaied.com/articles) [ Certificates ](https://msaied.com/certificates) [ Contact ](https://msaied.com#contact-section) [ ](https://github.com/EG-Mohamed) [ Home ](https://msaied.com) [ Projects ](https://msaied.com/projects) [ Articles ](https://msaied.com/articles) [ Certificates ](https://msaied.com/certificates) [ Contact ](https://msaied.com#contact-section) [ home ](https://msaied.com) [ articles ](https://msaied.com/articles) Queue::forward(): Reroute Laravel Queues in One Place On this page 1. [ The Problem Queue::forward() Solves ](#the-problem-queueforward-solves) 2. [ The API ](#the-api) 3. [ Routing by Environment ](#routing-by-environment) 4. [ What Queue::forward() Does Not Do ](#what-queueforward-does-not-do) 5. [ Key Takeaways ](#key-takeaways) ![Queue::forward(): Reroute Laravel Queues in One Place](https://cdn.msaied.com/572/c3ded57b390d88d1ceb9bd8570729835.png) [ Laravel ](https://msaied.com/articles?category=laravel) #Laravel #Queues #Laravel 13.26 #PHP #Queue Routing Queue::forward(): Reroute Laravel Queues in One Place ======================================================= 19 Aug 2026 3 min read ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said Table of contents 1. [ 01 The Problem Queue::forward() Solves ](#the-problem-queueforward-solves) 2. [ 02 The API ](#the-api) 3. [ 03 Routing by Environment ](#routing-by-environment) 4. [ 04 What Queue::forward() Does Not Do ](#what-queueforward-does-not-do) 5. [ 05 Key Takeaways ](#key-takeaways) The Problem Queue::forward() Solves ----------------------------------- Queue names have a habit of spreading across your codebase. A job class sets `onQueue('reports')`, a dispatch call chains `->onConnection('redis')`, a `#[Queue]` attribute pins another, and your worker configuration matches all of it. When you need to move that queue to a new Redis instance or rename it to satisfy a managed FIFO service, every one of those locations needs updating — including third-party packages you don't control. [Laravel 13.26](https://laravel-news.com/laravel-13-26-0) ships `Queue::forward()`, contributed by [@jackbayliss](https://github.com/jackbayliss) in [\#61188](https://github.com/laravel/framework/pull/61188). It lets you declare, in one place, that jobs dispatched to a given queue should land on a different queue, a different connection, or both. The API ------- All signatures take a source queue and a destination: ```php use Illuminate\Support\Facades\Queue; // Rename and move to another connection Queue::forward('reports', 'reports.fifo', 'cloud'); // Keep the name, change the connection Queue::forward('payments', connection: 'cloud'); // Rename on the same connection Queue::forward('updates', 'notifications'); // Map several queues at once Queue::forward([ 'reports' => 'reports.fifo', 'emails' => 'emails.fifo', ], connection: 'cloud'); ``` Queue names can be strings or backed enums. Register calls in a service provider's `boot()` method. Forwarding resolves through the same `getConnection()` hook that `Queue::route()` uses, so no new contract is required for custom drivers. **Important matching detail:** a forward that specifies a connection only rewrites the queue name for jobs headed to that connection. A job explicitly dispatched to `reports` on `redis` keeps its name even if a forward targets `reports` on `cloud`. Forwards are a mapping, not a global find-and-replace. Routing by Environment ---------------------- Registering forwards in a provider makes environment-specific routing straightforward: ```php namespace App\Providers; use Illuminate\Support\Facades\Queue; use Illuminate\Support\ServiceProvider; class AppServiceProvider extends ServiceProvider { public function boot(): void { if ($this->app->isProduction()) { Queue::forward([ 'reports' => 'reports.fifo', 'emails' => 'emails.fifo', ], connection: 'cloud'); } } } ``` Locally, `dispatch(new GenerateReport)` goes to `reports` on Redis as always. In production the identical code lands on `reports.fifo` on the managed connection. No environment checks inside job classes, no `config/queue.php` gymnastics. The same pattern handles operational moves that previously required touching many files: ```php // Offload a heavy queue to a dedicated Redis instance Queue::forward('encoding', connection: 'redis-heavy'); // Trial a new connection with one low-stakes queue Queue::forward('notifications', connection: 'sqs-experiment'); ``` Because a forward is one line, rolling back means deleting it — making gradual connection rollouts practical. What Queue::forward() Does Not Do --------------------------------- - **It applies at dispatch time only.** Jobs already sitting on the old queue stay there. Drain the old queue with workers before retiring it. - **Do not run workers against both names long-term.** The PR is explicit: once a forward is in place, treat the old queue name as deprecated and retire its workers after the drain to avoid race conditions. - **It does not pause or throttle consumption.** For stopping consumption, use the [queue pause API from Laravel 13.25](https://laravel-news.com/laravel-13-25-0). - **It does not reduce dispatch volume.** If noisy listeners are the problem, this release also ships [debounced queued listeners](https://laravel-news.com/laravel-debounced-queued-listeners). Key Takeaways ------------- - `Queue::forward()` centralises queue routing in a single service provider call. - Supports renaming, connection switching, or both — individually or in bulk. - Works with strings and backed enums; no custom driver changes needed. - Environment-conditional routing replaces scattered `onQueue()` / `onConnection()` calls. - Applies only to newly dispatched jobs; drain old queues before retiring their workers. --- *Source: [Queue::forward(): Reroute Laravel Queues in One Place — Laravel News](https://laravel-news.com/laravel-queue-forward)* Found this useful? [ ](https://twitter.com/intent/tweet?url=https%3A%2F%2Fmsaied.com%2Farticles%2Fqueueforward-reroute-laravel-queues-in-one-place&text=Queue%3A%3Aforward%28%29%3A+Reroute+Laravel+Queues+in+One+Place) [ ](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fmsaied.com%2Farticles%2Fqueueforward-reroute-laravel-queues-in-one-place) Frequently Asked Questions ---------------------------- 3 questions Q01 Does Queue::forward() affect jobs already sitting in the queue? No. Queue::forward() applies only at dispatch time, so jobs already on the old queue remain there. You need to drain the old queue with workers before retiring it. Running workers against both the original and forwarded queue names long-term can cause race conditions. Q02 Can I use Queue::forward() to route queues differently per environment? Yes. Because forwards are registered in a service provider's boot() method, you can wrap them in environment checks such as $this->app->isProduction(). This lets the same job dispatch code land on a local Redis queue in development and a managed FIFO queue in production without any changes to job classes. Q03 Does Queue::forward() require changes to custom queue drivers? No. Forwarding resolves through the same getConnection() hook that Queue::route() already uses, with the rename applied by each driver's own queue resolution. There is no new contract for custom drivers to implement. Continue reading More Articles --------------- [ View all ](https://msaied.com/articles) [ ![Advanced Authorization in Laravel: Gates, Policies, and Response-Based Access Control](https://cdn.msaied.com/571/e2c97418f4d543aac16e77c5dfd1055a.png) laravel authorization security ### Advanced Authorization in Laravel: Gates, Policies, and Response-Based Access Control Go beyond simple boolean gates. Learn how Laravel's response-based authorization lets you return rich denial r... ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said 20 Aug 2026 3 min read Read ](https://msaied.com/articles/advanced-authorization-in-laravel-gates-policies-and-response-based-access-control-4) [ ![Laravel Tackle: Run an AI Coding Agent Inside Your Laravel Application](https://cdn.msaied.com/573/8f6b08a47a4bf04ae26b9f03d8e2e697.png) Laravel AI Artisan ### Laravel Tackle: Run an AI Coding Agent Inside Your Laravel Application Laravel Tackle brings an AI coding agent directly into your app as Artisan commands. It can read routes, query... ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said 19 Aug 2026 4 min read Read ](https://msaied.com/articles/laravel-tackle-run-an-ai-coding-agent-inside-your-laravel-application) [ ![Read-Through Disks and Debounced Listeners in Laravel 13.26](https://cdn.msaied.com/568/580ae69765054f5f750614e4d977ff56.png) Laravel 13.26 Filesystem Queue ### Read-Through Disks and Debounced Listeners in Laravel 13.26 Laravel 13.26 ships a read-through filesystem driver for lazy storage migration, extends #\[DebounceFor\] to que... ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said 18 Aug 2026 4 min read Read ](https://msaied.com/articles/read-through-disks-and-debounced-listeners-in-laravel-1326) [ ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MH.png) Mohamed Said Laravel Backend Engineer ](https://msaied.com)Senior Backend Engineer specializing in Laravel, scalable SaaS platforms, APIs, and cloud infrastructure. I build secure, high-performance web applications that help businesses grow. Explore - [Home](https://msaied.com) - [Projects](https://msaied.com/projects) - [Articles](https://msaied.com/articles) - [Certificates](https://msaied.com/certificates) - [Contact](https://msaied.com#contact-section) Connect - [ hello@msaied.com ](mailto:hello@msaied.com) - [ +20 109 461 9204 ](tel:+201094619204) © 2026 Mohamed Said. All rights reserved. [ ](https://github.com/EG-Mohamed) [ ](https://www.linkedin.com/in/msaiedm/) [ ](https://wa.me/201094619204) [ ](mailto:hello@msaied.com) [ ](https://drive.google.com/file/u/0/d/1MF20IPRJyzfy32mhEutjL5EpSls0w2Q8/view)