filamentphp/filament · error · LogicException

Please use the `navigationItems()` method on the panel confi

Error message

Please use the `navigationItems()` method on the panel configuration to register navigation items. See the documentation - https://filamentphp.com/docs/panels/navigation#registering-custom-navigation-items

What it means

Error "Please use the `navigationItems()` method on the panel configuration to register navigation items. See the documentation - https://filamentphp.com/docs/panels/navigation#registering-custom-navigation-items" thrown in filamentphp/filament.

Source

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

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

    /**
     * @param  array<NavigationItem>  $items
     *
     * @deprecated Use the `navigationItems()` method on the panel configuration instead.
     */
    public function registerNavigationItems(array $items): void
    {
        try {
            $this->getDefaultPanel()->navigationItems($items);
        } catch (NoDefaultPanelSetException $exception) {
            throw new LogicException('Please use the `navigationItems()` method on the panel configuration to register navigation items. See the documentation - https://filamentphp.com/docs/panels/navigation#registering-custom-navigation-items');
        }
    }

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

    /**

View on GitHub (pinned to 53483fa934)

When it happens

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