Header Mapping

Headers become the names you use in filters and row.getCell(). Real app tables often include unlabeled checkbox columns, sort arrows, counts, percentages, or other UI-only text.

This visual focuses on how Smart Table turns rendered headers into stable column names.

ConfigHover a mapping rule

useTable(root, {

});

Header MapName blank columns automatically

Empty headers are still addressable with stable fallback names like __col_0.

Select row	Name	Role	Office ↑	Status %
	Airi Satou	Accountant	Tokyo	Active

blank__col_0

NameName

RoleRole

Office ↑Office

Status %Status

What To Notice

• Blank headers are still addressable with fallback names like __col_0.
• headerTransformer runs before names are stored, so you can remove sort arrows, counters, badges, or suffixes.
• The final names are what you use in calls like table.getRow({ Name: 'Airi Satou' }) and row.getCell('Office').

For the exact API, see headerSelector and headerTransformer.