filamentphp/filament · error · LogicException

Please use the `widgets()` method on the panel configuration

Error message

Please use the `widgets()` method on the panel configuration to register widgets.

What it means

Error "Please use the `widgets()` method on the panel configuration to register widgets." thrown in filamentphp/filament.

Source

Thrown at packages/panels/src/FilamentManager.php:1116

    {
        try {
            $this->getDefaultPanel()->userMenuItems($items);
        } catch (NoDefaultPanelSetException $exception) {
            throw new LogicException('Please use the `userMenuItems()` method on the panel configuration to register user menu items. See the documentation - https://filamentphp.com/docs/panels/navigation#customizing-the-user-menu');
        }
    }

    /**
     * @param  array<class-string>  $widgets
     *
     * @deprecated Use the `widgets()` method on the panel configuration instead.
     */
    public function registerWidgets(array $widgets): void
    {
        try {
            $this->getDefaultPanel()->widgets($widgets);
        } catch (NoDefaultPanelSetException $exception) {
            throw new LogicException('Please use the `widgets()` method on the panel configuration to register widgets.');
        }
    }

    public function getDefaultThemeMode(): ThemeMode
    {
        return $this->getCurrentOrDefaultPanel()->getDefaultThemeMode();
    }

    public function arePasswordsRevealable(): bool
    {
        return $this->getCurrentOrDefaultPanel()->arePasswordsRevealable();
    }

    public function getCurrentDomain(?string $testingDomain = null): string
    {
        if (filled($this->currentDomain)) {
            return $this->currentDomain;
        }

View on GitHub (pinned to 53483fa934)

When it happens

Trigger: Thrown at packages/panels/src/FilamentManager.php:1116 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/d74f31a69e9498fc. Report an issue: GitHub.