filamentphp/filament · error · LogicException

Please use the `navigationGroups()` method on the panel conf

Error message

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

What it means

Error "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" thrown in filamentphp/filament.

Source

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

    /**
     * @param  class-string  $pageClass
     */
    public function forPageConfiguration(string $pageClass, string $key): void
    {
        $this->setCurrentPageConfigurationKey($key);
    }

    /**
     * @param  array<string | int, NavigationGroup | string>  $groups
     *
     * @deprecated Use the `navigationGroups()` method on the panel configuration instead.
     */
    public function registerNavigationGroups(array $groups): void
    {
        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');
        }
    }

    /**

View on GitHub (pinned to 53483fa934)

When it happens

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