Troubleshooting

React Compiler

The standard useReactTable hook stores the table instance in a ref-like pattern using useState:

const [tableRef] = useState(() => ({
  current: createTable<TData>(resolvedOptions),
}))
// ...
return tableRef.current

React Compiler's automatic memoization can conflict with this manual memoization pattern, leading to stale state or rendering bugs.

Experimental Compat Hook

WARNING

This hook is experimental. It has been tested but may yield unexpected results in specific use cases. Only use this hook if you have React Compiler enabled — it provides no benefit otherwise.

useReactTableCompilerCompat_unstable is a drop-in replacement for useReactTable that is compatible with React Compiler. It opts out of our internal optimizations, relying instead on React Compiler's automatic memoization.

The API is identical to useReactTable.

import {useReactTableCompilerCompat_unstable} from "@qualcomm-ui/react/table"
import {getCoreRowModel} from "@qualcomm-ui/core/table"

const table = useReactTableCompilerCompat_unstable({
  data,
  columns,
  getCoreRowModel: getCoreRowModel(),
})

Last updated on Feb 27, 2026 by Ryan Bower

Installation

Overview

Guides