> ## Documentation Index
> Fetch the complete documentation index at: https://filament-34a8cf01.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Navigation

> [!WARNING]
>
> You are currently viewing the documentation for Filament 1.x, which is a previous version of Filament.
>
> Looking for the current stable version? Visit the [5.x documentation](https://filament-34a8cf01.mintlify.site/5.x/navigation).

By default, Filament will register navigation items for each of your [resources](https://filament-34a8cf01.mintlify.site/1.x/resources.md) and [custom pages](https://filament-34a8cf01.mintlify.site/1.x/pages.md). These classes contain static properties that you can override, to configure that navigation item and its order:

```php theme={"theme":"gruvbox-dark-hard"}
public static $icon = 'heroicon-o-document-text';

public static $navigationLabel = 'Custom Navigation Label';

public static $navigationSort = 3;
```

The `$icon` supports the name of any Blade component, and passes a set of formatting classes to it. By default, the [Blade Heroicons](https://github.com/blade-ui-kit/blade-heroicons) package is installed, so you may use the name of any [Heroicon](https://heroicons.com) out of the box. However, you may create your own custom icon components or install an alternative library if you wish.

Alternatively, you may completely override the static `navigationItems()` method on the class and register as many custom navigation items as you require:

```php theme={"theme":"gruvbox-dark-hard"}
use Filament\NavigationItem;

public static function navigationItems()
{
    return [
        NavigationItem::make($label, $url)
            ->activeRule($activeRule)
            ->icon($icon = 'heroicon-o-document-text')
            ->sort($sort = 0),
    ];
}
```

[Edit this page on GitHub](https://github.com/filamentphp/filament/edit/1.x/docs/07-navigation.md)

## Sponsored by

[Your logo here](https://github.com/sponsors/danharrin)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.