Laravel 13.31.0

The Laravel team released version 13.31.0 on September 8, 2026. This is a minor release under semantic versioning, so it adds new features and improvements without breaking existing applications.

Overview

Version 13.31.0 focuses on the queue system, Eloquent relationships, and developer tooling. Highlights include a new totalSize method on queue connections, a JobInterrupted event, and chaperone support for BelongsToMany pivot models.

New Features

• Queue totalSize() — contributed by Jack Bayliss, this method reports how many total jobs exist on a queue connection right now, replacing the manual sum of pending, delayed, and reserved sizes.
• JobInterrupted event — a new event fired when a job holding the Interruptible contract is interrupted by the worker, allowing cleanup or logging. Also contributed by Jack Bayliss.
• Chaperone support for BelongsToMany pivots — contributed by Caleb White, the chaperone() method on a BelongsToMany relationship retrieves the pivot model instance, enabling BelongsTo relations defined on custom pivot models during hydration.
• Vite devServerUrl() — a new method on the Vite class that returns the URL of the Vite development server, useful for generating asset URLs. Contributed by ramonmalcolm10.
• Once assertions — the Mail and Notification fakes gain once-style assertions, simplifying calls such as Mail::assertSentTimes.

Breaking Changes

None are listed for typical applications. As a minor release, 13.31.0 maintains backward compatibility. Developers should still review deprecations introduced in earlier 13.x releases before upgrading.

Contributors

This release includes contributions from Jack Bayliss, Caleb White, ramonmalcolm10, and talaridisTh, among others.

Update via composer require laravel/framework ^13.31.0.