# Search Faceted Sidebar

Multi-faceted filtering side panel for a product catalog with counts by category, brands, price ranges and ratings.

- id: `search-faceted-sidebar`
- Page: https://agentic-ui-kit.com/components/search-faceted-sidebar
- Live preview: https://agentic-ui-kit.com/live/component/search-faceted-sidebar

## Install

```bash
agentic-ui add search-faceted-sidebar
npx shadcn@4.17.0 add @agentic-ui/search-faceted-sidebar
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york)
- **Capabilities:** facet-counts, multi-select, clear-all, clear-facet, facet-search, range-slider-filter, collapsible-facet-groups, active-filter-badges, responsive-sheet-drawer, empty-state-handling, keyboard-navigation, accessible-labels
- **Intents:** manage-collection, explore-detail, navigate
- **Suits domains:** ecommerce, saas, knowledge, file-storage, operations, travel
- **Interaction:** click, checkbox-toggle, multi-select, clear-all, facet-search-input, range-slider-change, collapsible-toggle, drawer-open-close, keyboard-tab-navigation
- **Screen role:** management
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** multi-faceted filtering side panel for a product catalog with counts by category, brands, price ranges and ratings, document search sidebar with filters by file type, author, topic tags and modification dates, search navigation in a travel marketplace filtering by destinations, price range, amenities and reviews, advanced search sidebar in a help desk or issue tracker with statuses, priorities and assignees
- **Avoid when:** simple single-dimension filters over a small table that are solved with an inline select or dropdown, global search of application commands or actions, which corresponds to a command palette
- **Preserve when adapting:** multi-select-state-logic, facet-count-calculation, clear-all-and-clear-facet-affordances, responsive-sheet-on-mobile, collapsible-group-keyboard-accessibility
- **Replace when adapting:** facet-definitions-and-options, data-filtering-predicate, range-slider-bounds-and-step, icons-and-labels
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 9.2/10
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** checkbox, badge, button, input, separator, slider, sheet, collapsible
- **npm dependencies:** lucide-react
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives