Guide

Customise the Filament sidebar

Collapse it, resize it, recolour it, regroup it, or replace it, in FilamentPHP v4 and v5. Built-in options first, plugins after.

Who wrote this

FilaFly makes Rail and Citrus, which change the sidebar and are listed below. Most of this page needs no plugin at all: the built-in options come from Filament's own v4 and v5 docs, and the other plugins are listed with prices, Filament versions and Packagist installs taken from the Filament plugin directory and Packagist. Checked November 16, 2026.

Everything below works the same in Filament v4 and v5: the sidebar options, render hooks and CSS classes are identical in both (checked against v4.16.4 and v5.11.4). Panel options go in your panel provider, usually app/Providers/Filament/AdminPanelProvider.php.

Collapse the sidebar on desktop

On mobile the sidebar is always a slide-out menu. On desktop it stays open unless you allow collapsing:

// Shrinks to an icon-only rail; icons stay visible.
$panel->sidebarCollapsibleOnDesktop();

// Or, instead: hides the sidebar completely when collapsed.
$panel->sidebarFullyCollapsibleOnDesktop();

Use one or the other, not both.

Both accept a boolean or a closure, so you can turn them on per user or per panel. When the sidebar collapses to icons, give your navigation groups an icon: in the collapsed sidebar the group icon opens a dropdown of its items.

Change the sidebar width

$panel
    ->sidebarWidth('18rem')          // default 20rem
    ->collapsedSidebarWidth('5rem'); // default 4.5rem, with sidebarCollapsibleOnDesktop()

Filament writes these to the --sidebar-width and --sidebar-collapsed-width CSS variables, which is why the old trick of overriding the variable in CSS (asked on Stack Overflow for v3) is no longer needed.

Change the sidebar colour

There is no panel option for the sidebar colour; you style it with CSS in a custom theme. Create one with php artisan make:filament-theme, then add to resources/css/filament/admin/theme.css:

.fi-sidebar {
    @apply bg-gray-50 dark:bg-gray-950;
}

Run npm run build. That example is the one in Filament's CSS hooks docs; add ! (!bg-gray-50) if another style wins. Other sidebar classes you can target include .fi-sidebar-header, .fi-sidebar-nav, .fi-sidebar-group-label, .fi-sidebar-item (with .fi-active on the current page), .fi-sidebar-item-icon and .fi-sidebar-footer. Only .fi-sidebar is named in the docs; the others come from Filament's Blade views, so check them after an upgrade. Filament advises against publishing its views to restyle them.

The panel's ->colors() primary colour already sets the active item colour, so you may not need CSS for that.

Group, sort, badge and hide items

Each resource or page controls its own sidebar item with static properties. On a resource:

use BackedEnum;
use Filament\Support\Icons\Heroicon;
use UnitEnum;

protected static string | BackedEnum | null $navigationIcon = Heroicon::OutlinedDocumentText;
protected static string | UnitEnum | null $navigationGroup = 'Settings';
protected static ?int $navigationSort = 3;

public static function getNavigationBadge(): ?string
{
    return (string) static::getModel()::where('status', 'new')->count();
}

The badge example counts the resource's model; on a custom page, which has no model, write the query out instead of using static::getModel().

  • Order groups with ->navigationGroups(['Shop', 'Blog', 'Settings']) on the panel, or pass NavigationGroup::make() objects to set an icon, start a group collapsed, or stop it collapsing.
  • No collapsible groups: ->collapsibleNavigationGroups(false).
  • Nest an item under another with $navigationParentItem.
  • Hide an item: protected static bool $shouldRegisterNavigation = false;, or override shouldRegisterNavigation() to decide per user. The docs warn this only hides the link; the URL still works, so protect it with a policy or canAccess().
  • Reload the sidebar after a change (a badge count, say) by dispatching the refresh-sidebar event.

Add your own content to the sidebar

Render hooks put a Blade view at fixed points in the sidebar without overriding anything. Register them in a service provider:

use Filament\Support\Facades\FilamentView;
use Filament\View\PanelsRenderHook;

FilamentView::registerRenderHook(
    PanelsRenderHook::SIDEBAR_FOOTER,
    fn () => view('filament.sidebar-footer'),
);

The sidebar hooks are SIDEBAR_START, SIDEBAR_LOGO_BEFORE, SIDEBAR_LOGO_AFTER, SIDEBAR_NAV_START, SIDEBAR_NAV_END and SIDEBAR_FOOTER (pinned to the bottom), listed in the render hooks docs. There is no SIDEBAR_END.

Move things in or out of the sidebar

  • ->topNavigation(): navigation in the top bar instead of a sidebar.
  • ->userMenu(position: \Filament\Enums\UserMenuPosition::Sidebar): the user menu in the sidebar.
  • ->topbar(false): no top bar; the user menu then moves to the sidebar by itself.
  • ->navigation(false): no navigation at all, or a closure to decide (during onboarding, say), or build the whole menu yourself with a NavigationBuilder.
  • ->sidebarLivewireComponent(...): swap in your own Livewire component for the sidebar, for when nothing else is enough.

FilaFly options

Our own sidebar products, with the same facts we give for everyone else.

Product What it does to the sidebar Filament Price
Rail (plugin) Adds a slim dark icon rail beside the sidebar: your logo, a tile per tenant, quick links and the notifications bell. Shows from 64rem wide up. v4, v5 Free (MIT)
Citrus (theme) Removes the top bar: the logo, search and user menu move into the sidebar, and each page gets a sticky glass header. The rest of the panel is restyled too. v4 & v5 from USD 59.00

Rail was taken from the Citrus theme and works on any panel, with or without a theme.

Other sidebar plugins

From the plugin directory, with Packagist downloads (total, and the last 30 days) on November 16, 2026. All are free unless marked.

Plugin What it does Filament Downloads
Page with Sidebar (Ayman Alhattami) Gives a resource's pages their own sidebar menu. v2, v3, v4 (no v5 yet) 240,609 / 14,778
Mobile Bottom Navigation (Hammad Zafar) An app-style bottom navigation bar on phones. v4, v5 84,290 / 14,456
Navigation Enhanced (AGMedia) Collapsible child items in the sidebar. v5 26,864 / 10,768
Sidebar Resize (Martin Khachatryan) Drag to resize the sidebar; the width is remembered. v5 9,293 / 3,822
Pinnable Navigation (Devletes) Lets users pin favourite items. v5 8,267 / 2,219
Hover Sidebar (Vitis Studio) An icon-only sidebar that expands on hover and can be pinned open. v5 2,513 / 1,292
Drilldown Sidebar (Osama Atef) Groups slide into their own panel of items. v3, v4, v5 2,179 / 537
Navigator (Komma SoftHouse) Manage the navigation from inside the panel, with custom icons. v5 Paid, $49 (not on Packagist)

Downloads are Packagist download counts, not unique installs. Several themes also change the sidebar (a detached or full-height sidebar, say); see Filament themes compared.

Frequently asked questions

How do I make the Filament sidebar collapsible on desktop?

Call ->sidebarCollapsibleOnDesktop() on the panel in your panel provider. The sidebar then shrinks to icons. Use ->sidebarFullyCollapsibleOnDesktop() instead to hide it completely.

How do I change the Filament sidebar width?

Use ->sidebarWidth('18rem') on the panel. The default is 20rem. The collapsed icon-only width is set with ->collapsedSidebarWidth() and defaults to 4.5rem.

How do I change the Filament sidebar colour?

Create a custom theme with php artisan make:filament-theme, then style the .fi-sidebar class in the theme CSS, for example .fi-sidebar { @apply bg-gray-50 dark:bg-gray-950; }, and rebuild with npm run build.

How do I hide an item from the Filament sidebar?

Set protected static bool $shouldRegisterNavigation = false on the resource or page, or override shouldRegisterNavigation(). This only hides the link; it does not stop someone opening the URL, so use policies or canAccess() for that.

Can Filament use top navigation instead of a sidebar?

Yes. Call ->topNavigation() on the panel and the navigation moves into the top bar.