Migrating from Spatie

This guide helps you migrate from spatie/laravel-sluggable to oliwol/laravel-slugify.

Side-by-Side Comparison

Basic Configuration

spatie/laravel-sluggable

use Spatie\Sluggable\HasSlug;
use Spatie\Sluggable\SlugOptions;

class Post extends Model
{
    use HasSlug;

    public function getSlugOptions(): SlugOptions
    {
        return SlugOptions::create()
            ->generateSlugsFrom('title')
            ->saveSlugsTo('slug');
    }
}

oliwol/laravel-slugify

use Oliwol\Slugify\HasSlug;
use Oliwol\Slugify\Slugify;

#[Slugify(from: 'title', to: 'slug')]
class Post extends Model
{
    use HasSlug;
}

Multiple Source Fields

spatie/laravel-sluggable

SlugOptions::create()
    ->generateSlugsFrom(['first_name', 'last_name'])
    ->saveSlugsTo('slug');

oliwol/laravel-slugify

#[Slugify(from: ['first_name', 'last_name'], to: 'slug')]

Custom Separator

spatie/laravel-sluggable

SlugOptions::create()
    ->generateSlugsFrom('title')
    ->saveSlugsTo('slug')
    ->usingSeparator('_');

oliwol/laravel-slugify

#[Slugify(from: 'title', to: 'slug', separator: '_')]

Max Length

spatie/laravel-sluggable

SlugOptions::create()
    ->generateSlugsFrom('title')
    ->saveSlugsTo('slug')
    ->slugsShouldBeNoLongerThan(50);

oliwol/laravel-slugify

#[Slugify(from: 'title', to: 'slug', maxLength: 50)]

Prevent Regeneration on Update

spatie/laravel-sluggable

SlugOptions::create()
    ->generateSlugsFrom('title')
    ->saveSlugsTo('slug')
    ->doNotGenerateSlugsOnUpdate();

oliwol/laravel-slugify

#[Slugify(from: 'title', to: 'slug', regenerateOnUpdate: false)]

Custom Slug Generation

spatie/laravel-sluggable

SlugOptions::create()
    ->generateSlugsFrom(function ($model) {
        return $model->category->name . ' ' . $model->title;
    })
    ->saveSlugsTo('slug');

oliwol/laravel-slugify

#[Slugify(from: 'getFullTitle', to: 'slug')]
class Post extends Model
{
    use HasSlug;

    public function getFullTitle(): string
    {
        return $this->category->name . ' ' . $this->title;
    }
}

Migration Checklist

1. Replace the dependency

   composer remove spatie/laravel-sluggable
   composer require oliwol/laravel-slugify

2. Update imports in all model files:

   • Spatie\Sluggable\HasSlug → Oliwol\Slugify\HasSlug
   • Remove use Spatie\Sluggable\SlugOptions;
   • Add use Oliwol\Slugify\Slugify;

3. Replace getSlugOptions() with #[Slugify] attribute on the class

4. Update translatable slugs (if applicable):

   • Spatie\Sluggable\HasTranslatableSlug → Oliwol\Slugify\HasTranslatableSlug

5. Test your application — existing slugs in the database are not affected

Common Gotchas

Closure sources become methods

Spatie allows inline closures for slug generation. Laravel Slugify uses named methods instead — reference the method name as a string in from:

// Spatie: closure
->generateSlugsFrom(fn ($model) => $model->title . '-' . $model->id)

// Slugify: named method
#[Slugify(from: 'getSlugSource', to: 'slug')]

public function getSlugSource(): string
{
    return $this->title . '-' . $this->id;
}

getSlugOptions() must be removed

If you keep the old getSlugOptions() method alongside #[Slugify], the method won't be called — it's a Spatie-specific convention. Remove it to avoid confusion.

Scoping works differently

Spatie has no built-in scoping for uniqueness. If you used custom query logic, use scopeSlugQuery():

public function scopeSlugQuery($query)
{
    return $query->where('tenant_id', $this->tenant_id);
}

Existing database slugs are preserved

Switching packages does not affect existing slugs in your database. The new trait only generates slugs on save. To regenerate all slugs with the new configuration, use the Artisan command:

php artisan slugify:generate "App\Models\Post" --force

Feature Comparison

Feature	spatie/laravel-sluggable	oliwol/laravel-slugify
Attribute-based config	No	Yes (#[Slugify])
Method-based config	getSlugOptions()	Method overrides
Multiple source fields	Yes	Yes
Custom separator	Yes	Yes
Max length	Yes	Yes (word-boundary aware)
Prevent update regeneration	Yes	Yes
Slug uniqueness	Yes	Yes
Custom scoping	No	Yes (scopeSlugQuery)
Slug history	No	Yes (HasSlugHistory)
Events	No	Yes (SlugGenerated, SlugUpdated)
findBySlug()	Yes	Yes
Translatable slugs	Yes	Yes
Artisan command	No	Yes (slugify:generate)
Closure source	Yes	Via method source