# What changed in @docsearch/css

> 19 changes in @docsearch/css 5 from its official release notes, upgrade guides and advisories: 9 breaking, 6 new APIs and options. Each one cited. Sources checked 2026-10-25. HTML: https://unstale.sh/npm/@docsearch/css/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @docsearch/css 5

### Breaking changes

- 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.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.1.0)
- Corrects the misspelled class name; custom styles overriding the old name must update their selectors. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)
- Replaces `.DocSearch-Hit-icon--small` with a modifier that top-aligns the icon; recent conversations use it. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)
- Renames the `shimmer` utility class to follow the DocSearch naming convention. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)
- Renames the `fadeIn` keyframe to kebab-case; custom styles overriding it must update their selectors. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)
- Dark theme selectors now target `:root` instead of `html`; custom style overrides must update their selectors. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)
- The search input and modal heading are now 1rem at every breakpoint instead of 0.875rem with a mobile-only override. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)
- Renames the `shimmerText` keyframe to kebab-case; custom styles overriding it must update their selectors. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)
- Renames the `slideDown` keyframe to kebab-case; custom styles overriding it must update their selectors. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)

### New APIs and options

- Adds a background variable used to restyle markdown code blocks. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)
- Adds a color variable used to restyle the Ask AI error panel. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)
- Adds a color variable used to restyle the Ask AI error panel. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)
- 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.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)
- Adds a footer action container for a custom action rendered before the Algolia logo. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)
- Adds a wrapper around the footer actions. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)

### Behavior and default changes

- 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.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.1.0)

### Fixes and other changes

- Drops redundant type qualifiers, slightly lowering selector specificity. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)
- Drops redundant type qualifiers, slightly lowering selector specificity. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)
- Uses 1.5em line height and wraps long titles anywhere to prevent overlap. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/css%405.0.0)