Global search

An expandable global search box appears in the toolbar by default (enableGlobalFilter: true). It filters across all searchable columns at once, complementing the per-column filters.

Search modes

When enableGlobalFilterModes: true (the default), the search box shows a mode menu — fuzzy, contains, and more. The initial mode comes from defaultGlobalFilterMode, which defaults to "fuzzy".

import { DataTable, useDataTable } from "@/components/ui/data-table"

const table = useDataTable({
  data,
  columns,
  getRowId: (row) => row.id,
  enableGlobalFilter: true,
  enableGlobalFilterModes: true,
  defaultGlobalFilterMode: "fuzzy",
})
return <DataTable table={table} />

Disabling global search

Set enableGlobalFilter: false to remove the search box from the toolbar.

const table = useDataTable({
  data,
  columns,
  getRowId: (row) => row.id,
  enableGlobalFilter: false,
})

Custom mode menu

Replace the built-in mode radio items with renderGlobalFilterModeMenuItems. It receives the allowed modes, the currentMode, and an onSelect(mode) to switch.

import { DropdownMenuItem } from "@/components/ui/dropdown-menu"

useDataTable({
  renderGlobalFilterModeMenuItems: ({ modes, currentMode, onSelect }) =>
    modes.map((mode) => (
      <DropdownMenuItem
        key={mode}
        disabled={mode === currentMode}
        onClick={() => onSelect(mode)}
      >
        {mode}
      </DropdownMenuItem>
    )),
})

Ranked results

In fuzzy mode, each match carries a relevance score. Set enableGlobalFilterRankedResults to order rows by that score — best matches first — for as long as a search is active.

const table = useDataTable({
  data,
  columns,
  getRowId: (row) => row.id,
  defaultGlobalFilterMode: "fuzzy",
  enableGlobalFilterRankedResults: true,
})

The ranking yields to the user: the moment they click a column to sort, their sort takes over, and clearing the search restores the original order. It applies only in "fuzzy" mode and is skipped while grouping or row expansion is active, or under manualSorting / manualFiltering (the server owns ordering there).

Placement

Move the search to the left toolbar region with positionGlobalFilter: "left" — see Toolbar customization.

Relevant options

Related

• Column filtering
• Filter modes