Laravel Sluggable Laravel Package

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/4.0.0...4.0.1

v4 is mostly additive. Breaking changes are limited to minimum versions and a small handful of API removals. Full details in UPGRADING.md.

Highlights

• #[Sluggable] attribute as a drop-in alternative to the HasSlug trait. Trait-based models keep working unchanged.
• Self-healing URLs: route keys that combine the slug with the primary key (hello-world-5) so renaming a model never breaks an existing link. Stale URLs return a 308 (was 301) so PUT/PATCH/DELETE keep working.
• Overridable actions: swap the slug generator or self-healing URL builder/parser via config/sluggable.php.
• Laravel Boost skill bundled with the package for AI assistants.

Breaking changes

• Minimum PHP 8.3 and Laravel 12. spatie/laravel-translatable v6+ when using HasTranslatableSlug. Pest 4 / Testbench 10+ in your test suite.
• skipGenerateWhen() is now evaluated on every save instead of once. The SlugOptions::\$skipGenerate boolean is gone in favor of \$skipGenerateWhen.
• The closure-shaped options (generateSlugsFrom, extraScope, usingSuffixGenerator, skipGenerateWhen) are typed as Closure. Array/string callables need wrapping in a fn.
• HasSlug no longer keeps a protected \$slugOptions cache; override generateSlugAction() to inject custom behavior instead.
• Self-healing redirects default to 308 Permanent Redirect.
• The Sluggable facade was renamed to SelfHealing.

See UPGRADING.md for migration steps.

What's Changed

• Fix preventOverwrite for translatable slugs (#304)

Thanks to @jyrkidn for reporting and providing the initial fix in #302.

What's Changed

• Add Laravel 13 and PHP 8.5 support
• Drop Laravel 8/9 and PHP 8.0/8.1 (EOL)

What's Changed

• Also account for HasManyThrough / BelongsToMany relations by @mabdullahsari in https://github.com/spatie/laravel-sluggable/pull/291

New Contributors

• @mabdullahsari made their first contribution in https://github.com/spatie/laravel-sluggable/pull/291

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.7.4...3.7.5

What's Changed

• Allow to generate custom suffixes by @josepdecid in https://github.com/spatie/laravel-sluggable/pull/289

New Contributors

• @josepdecid made their first contribution in https://github.com/spatie/laravel-sluggable/pull/289

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.7.3...3.7.4

What's Changed

• Bump dependabot/fetch-metadata from 2.2.0 to 2.3.0 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/287
• Laravel 12.x Compatibility by @laravel-shift in https://github.com/spatie/laravel-sluggable/pull/288

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.7.2...3.7.3

What's Changed

• Fix query for translatable slug by @andrii-trush in https://github.com/spatie/laravel-sluggable/pull/285

New Contributors

• @andrii-trush made their first contribution in https://github.com/spatie/laravel-sluggable/pull/285

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.7.1...3.7.2

What's Changed

• Add explicit nullable type for additionalQuery parameter by @RomkaLTU in https://github.com/spatie/laravel-sluggable/pull/286

New Contributors

• @RomkaLTU made their first contribution in https://github.com/spatie/laravel-sluggable/pull/286

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.7.0...3.7.1

What's Changed

• Changing reference to Laravel docs without Laravel version by @abishekrsrikaanth in https://github.com/spatie/laravel-sluggable/pull/274
• Bump dependabot/fetch-metadata from 1.6.0 to 2.1.0 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/278
• Bump dependabot/fetch-metadata from 2.1.0 to 2.2.0 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/281
• Add Fallback Locale and Additional Query Support to findBySlug by @mkeremcansev in https://github.com/spatie/laravel-sluggable/pull/284

New Contributors

• @abishekrsrikaanth made their first contribution in https://github.com/spatie/laravel-sluggable/pull/274
• @mkeremcansev made their first contribution in https://github.com/spatie/laravel-sluggable/pull/284

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.6.0...3.7.0

What's Changed

• Bump dependabot/fetch-metadata from 1.4.0 to 1.5.1 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/257
• Bump dependabot/fetch-metadata from 1.5.1 to 1.6.0 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/261
• Bump actions/checkout from 3 to 4 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/264
• Add laravel 11 support by @mokhosh in https://github.com/spatie/laravel-sluggable/pull/271

New Contributors

• @mokhosh made their first contribution in https://github.com/spatie/laravel-sluggable/pull/271

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.5.0...3.6.0

What's Changed

• Bump dependabot/fetch-metadata from 1.3.5 to 1.3.6 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/250
• Fix badge with build status in README.md by @gomzyakov in https://github.com/spatie/laravel-sluggable/pull/252
• Bump dependabot/fetch-metadata from 1.3.6 to 1.4.0 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/255
• feat: add findBySlug alias by @IsraelOrtuno in https://github.com/spatie/laravel-sluggable/pull/256

New Contributors

• @gomzyakov made their first contribution in https://github.com/spatie/laravel-sluggable/pull/252
• @IsraelOrtuno made their first contribution in https://github.com/spatie/laravel-sluggable/pull/256

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.4.2...3.5.0

• update for Laravel 10

What's Changed

• Update README.md by @furiouskj in https://github.com/spatie/laravel-sluggable/pull/240
• composer allow-plugins config by @hotsaucejake in https://github.com/spatie/laravel-sluggable/pull/241
• Normalize composer.json by @patinthehat in https://github.com/spatie/laravel-sluggable/pull/247
• Add Dependabot Automation by @patinthehat in https://github.com/spatie/laravel-sluggable/pull/246
• Add PHP 8.2 Support by @patinthehat in https://github.com/spatie/laravel-sluggable/pull/245
• Bump actions/checkout from 2 to 3 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/248
• Allow set slug suffix starting number by @Vediovis in https://github.com/spatie/laravel-sluggable/pull/249

New Contributors

• @furiouskj made their first contribution in https://github.com/spatie/laravel-sluggable/pull/240
• @hotsaucejake made their first contribution in https://github.com/spatie/laravel-sluggable/pull/241
• @dependabot made their first contribution in https://github.com/spatie/laravel-sluggable/pull/248
• @Vediovis made their first contribution in https://github.com/spatie/laravel-sluggable/pull/249

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.4.0...3.4.1

What's Changed

• Converts Test cases to Pest tests by @marvin-wtt in https://github.com/spatie/laravel-sluggable/pull/223
• Add ability to skip the slug generation by a condition by @masterix21 in https://github.com/spatie/laravel-sluggable/pull/227

New Contributors

• @masterix21 made their first contribution in https://github.com/spatie/laravel-sluggable/pull/227

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.3.1...3.4.0

What's Changed

• Add support for spatie/laravel-translatable:^6.0 by @mziraki in https://github.com/spatie/laravel-sluggable/pull/224

New Contributors

• @mziraki made their first contribution in https://github.com/spatie/laravel-sluggable/pull/224

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.3.0...3.3.1

• support Laravel 9

What's Changed

• Adds support for implicit route model binding with translated slugs by @marvin-wtt in https://github.com/spatie/laravel-sluggable/pull/213

New Contributors

• @marvin-wtt made their first contribution in https://github.com/spatie/laravel-sluggable/pull/213

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.1.1...3.2.0

What's Changed

• Migrate to PHP-CS-Fixer 3.x by @shuvroroy in https://github.com/spatie/laravel-sluggable/pull/203
• Adds test case for replicate method by @eduarguz in https://github.com/spatie/laravel-sluggable/pull/212
• Fix Deprecation: currentSlug is null by @phh in https://github.com/spatie/laravel-sluggable/pull/218

New Contributors

• @shuvroroy made their first contribution in https://github.com/spatie/laravel-sluggable/pull/203
• @eduarguz made their first contribution in https://github.com/spatie/laravel-sluggable/pull/212
• @phh made their first contribution in https://github.com/spatie/laravel-sluggable/pull/218

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.1.0...3.1.1

• add extra scope callback option (#201)

• bugfix for updating slugs generated from a callback (#200)

• update slug on non unique names (#195)

• require PHP 8+
• drop support for PHP 7.x
• convert syntax to PHP 8
• move Exceptions to Exceptions folder to match structure of other packages

• Added translatable slug overriding (#190)

• fix Eloquent model checking (#186)

• add preventOverwrite
• add support for PHP 8

• fixed an incompatibility bug with postgresql uuid column (#173)

• add support for Laravel 8

• add helper trait to integrate with laravel-translatable #155

• fix bug that causes empty slugs when dealing with multi-bytes chars (#152)

• use method for retrieving incrementing status of the model (#151)

L7

• add support for Laravel 7, drop support for Laravel 6

• drop support for anything below PHP 7.4 and Laravel 6