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 passNavigationGroup::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 overrideshouldRegisterNavigation()to decide per user. The docs warn this only hides the link; the URL still works, so protect it with a policy orcanAccess(). - Reload the sidebar after a change (a badge count, say) by dispatching the
refresh-sidebarevent.
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 aNavigationBuilder.->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.