filamentphp/filament · error · InvalidArgumentException

Global search provider {$provider} does not implement the [F

Error message

Global search provider {$provider} does not implement the [Filament\GlobalSearch\Providers\Contracts\GlobalSearchProvider] interface.

What it means

Error "Global search provider {$provider} does not implement the [Filament\GlobalSearch\Providers\Contracts\GlobalSearchProvider] interface." thrown in filamentphp/filament.

Source

Thrown at packages/panels/src/Panel/Concerns/HasGlobalSearch.php:34

    protected GlobalSearchPosition | Closure | null $globalSearchPosition = null;

    protected string | Closure | null $globalSearchDebounce = null;

    /**
     * @var array<string>
     */
    protected array $globalSearchKeyBindings = [];

    protected string | bool $globalSearchProvider = true;

    protected string | Closure | null $globalSearchFieldSuffix = null;

    protected bool $isGlobalSearchResourceOptIn = false;

    public function globalSearch(string | bool $provider = true, GlobalSearchPosition | Closure | null $position = null): static
    {
        if (is_string($provider) && (! in_array(GlobalSearchProvider::class, class_implements($provider)))) {
            throw new InvalidArgumentException("Global search provider {$provider} does not implement the [" . GlobalSearchProvider::class . '] interface.');
        }

        $this->globalSearchProvider = $provider;
        $this->globalSearchPosition = $position;

        return $this;
    }

    public function globalSearchDebounce(string | Closure | null $debounce): static
    {
        $this->globalSearchDebounce = $debounce;

        return $this;
    }

    /**
     * @param  array<string>  $keyBindings
     */

View on GitHub (pinned to 53483fa934)

When it happens

Trigger: Thrown at packages/panels/src/Panel/Concerns/HasGlobalSearch.php:34 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of filamentphp/filament@53483fa934 (2026-08-17). Data as JSON: /api/errors/cd34925ea5b1c921. Report an issue: GitHub.