> ## Documentation Index
> Fetch the complete documentation index at: https://algolia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ColorRefinementList

> Shows facet values as colors for filtering search results.

<Note>
  This is the **React InstantSearch v7** documentation.
  If you're upgrading from v6, see the [upgrade guide](/doc/guides/building-search-ui/upgrade-guides/react/#migrate-from-react-instantsearch-v6-to-react-instantsearch-v7).
  If you were using React InstantSearch Hooks,
  this v7 documentation applies—just check for [necessary changes](/doc/guides/building-search-ui/upgrade-guides/react/#migrate-from-react-instantsearch-hooks-to-react-instantsearch-v7).
  To continue using v6, you can find the [archived documentation](https://algolia.com/old-docs/deprecated/instantsearch/react/v6/api-reference/instantsearch/).
</Note>

<Note>
  This widget is [only available in React InstantSearch v6](https://www.algolia.com/old-docs/deprecated/instantsearch/react/v6/api-reference/color-refinement-list/).
  Vote on this [open issue](https://alg.li/0zdqHL) if you want this widget to be available in React InstantSearch,
  and help prioritize its development.
</Note>

## About this widget

This widget that filters results based on color facet values.

It only displays the most relevant colors for the current search context.

<Card title="Open CodeSandbox" icon="codesandbox" href="https://codesandbox.io/s/github/algolia/react-instantsearch-widget-color-refinement-list?file=/example/index.tsx">
  Run and edit the ColorRefinementList example in CodeSandbox.
</Card>