SearchKit Box

Development Status
Work In Progress
Active Installs
Maintainers
Download

Last updated: 2026-07-20

Works with CiviCRM 6.10 or higher.

Search and Reports

SearchKit Box adds an enhanced box grid display type to CiviCRM SearchKit. Like the contributed Searchkit Cards extension it lays search results out as boxes in a grid, but it adds a configurable boxes-per-row grid, selectable box styles (including a compact Board preset), rich per-field roles (icon rows, colored badges, status dots, avatars, a kebab menu), a split footer, and an optional left-edge accent bar — all styled natively from the active CiviCRM theme.

Features

  • A Box display type in the SearchKit display editor.
  • Boxes per row: a CSS-grid layout with either a fixed column count (1–12) or an auto mode (fill by a minimum box width). Degrades gracefully on narrow screens.
  • Box styles: default, compact, outlined, and board (compact + accent + footer + single-line ellipsized title).
  • Per-field roles: title, subtitle, body, icon row (leading icon + value), badge (colored pill), status dot, image (cover), avatar (round), and menu (kebab).
  • Placement regions: each field can be placed in the header, body, footer left, or footer right (or left to a sensible default for its role).
  • Left-edge accent bar, colored per record value.
  • Box background tint, a soft whole-box background colored per record value (independent of the accent — both can apply at once).
  • Theme-native styling: every color, border, radius, shadow and spacing value comes from the active theme (RiverLea --crm-* custom properties) with Greenwich-safe fallbacks — boxes follow the current stream and dark mode automatically.
  • Value rendering (links, buttons, rewrite, conditional CSS rules, icons, inline images) is delegated to the core SearchKit column machinery, so those features work inside boxes for free.
  • Optional Bootstrap 4 class emission for BS4-based CMS themes.
Screenshot