unstale

npm / @docsearch/css

@docsearch/css

What changed in @docsearch/css 5, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-25.

9 breaking6 new APIs and options1 behavior and defaults3 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.6 on npm

@docsearch/css 519 changes

Breaking changes 9

  • FacetBar renders checkbox items instead of a radio group, allowing users to select multiple values per facet; values within a facet are combined with OR, while different facets are combined with AND.

    5.1.0release notes

  • Corrects the misspelled class name; custom styles overriding the old name must update their selectors.

    5.0.0release notes

  • Replaces .DocSearch-Hit-icon--small with a modifier that top-aligns the icon; recent conversations use it.

    5.0.0release notes

  • Renames the shimmer utility class to follow the DocSearch naming convention.

    5.0.0release notes

  • Renames the fadeIn keyframe to kebab-case; custom styles overriding it must update their selectors.

    5.0.0release notes

  • Dark theme selectors now target :root instead of html; custom style overrides must update their selectors.

    5.0.0release notes

  • The search input and modal heading are now 1rem at every breakpoint instead of 0.875rem with a mobile-only override.

    5.0.0release notes

  • Renames the shimmerText keyframe to kebab-case; custom styles overriding it must update their selectors.

    5.0.0release notes

  • Renames the slideDown keyframe to kebab-case; custom styles overriding it must update their selectors.

    5.0.0release notes

New APIs and options 6

  • Adds a background variable used to restyle markdown code blocks.

    5.0.0release notes

  • Adds a color variable used to restyle the Ask AI error panel.

    5.0.0release notes

  • Adds a color variable used to restyle the Ask AI error panel.

    5.0.0release notes

  • Adds a font-family variable used across the search button, keyboard keys, modal, and sidepanel, allowing all DocSearch surfaces to be themed together.

    5.0.0release notes

  • Adds a footer action container for a custom action rendered before the Algolia logo.

    5.0.0release notes

  • Adds a wrapper around the footer actions.

    5.0.0release notes

Behavior and default changes 1

  • OR groups containing values for a single facet are recognized as that facet's default selection, in addition to single key:value entries.

    5.1.0release notes

Fixes and other changes 3

  • Drops redundant type qualifiers, slightly lowering selector specificity.

    5.0.0release notes

  • Drops redundant type qualifiers, slightly lowering selector specificity.

    5.0.0release notes

  • Uses 1.5em line height and wraps long titles anywhere to prevent overlap.

    5.0.0release notes