optimistdigital/laravel-scout-batch-searchable

This Laravel package adds a BatchSearchable trait to allow batching Scout updates.

Maintainers

👁 Tarpsvo

Package info

github.com/outl1ne/laravel-scout-batch-searchable

pkg:composer/optimistdigital/laravel-scout-batch-searchable

Statistics

Installs: 12 444

Dependents: 0

Suggesters: 0

Stars: 31

Open Issues: 1

2.2.4 2025-05-22 11:26 UTC

Requires

Requires (Dev)

None

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT f03e35b1dd720f23394c54f318e3822a5b4ff5ca

laravelbatchscout

This package is auto-updated.

Last update: 2026-06-22 13:58:46 UTC


README

👁 Latest Version on Packagist
👁 Total Downloads

This Laravel package allows for batching of Scout updates.

Requirements

  • Laravel Scout 9+
  • Scheduler with cron

Description

This package provides a new trait BatchSearchable that should be used instead of the regular Searchable trait provided by Laravel Scout.

Using that trait, all updates pushed through Scout to the search server (whether it be MeiliSearch, Algolia or whatever else), are batched together instead of being sent one-by-one.

The updates are sent on two possible conditions:

Either scout.batch_searchable_max_batch_size (default 250) is exeeded

or

scout.batch_searchable_debounce_time_in_min (default 1) minutes have passed from the last update to the pending queue

The IDs of models that require updating are stored in the default cache layer using the Cache helper.

The debounce check uses Laravel's Scheduler to schedule a job that checks through all the pending update queues and sees if the required time has passed. This requires that the system has a working cron setup that calls schedule:run every minute.

Installation

Install the package in a Laravel Nova project via Composer and run migrations:

composer require outl1ne/laravel-scout-batch-searchable

Usage

Where you previously used the Searchable trait, just use BatchSearchable instead:

use Outl1ne\ScoutBatchSearchable\BatchSearchable;

class SomeModel extends Model {
 use BatchSearchable;
}

Credits

License

Laravel Scout Batch Searchable is open-sourced software licensed under the MIT license.