Column By

Configure default board columns and column options

Board View Only: Column By is only for Board view.

Overview

Column By defines board columns. It uses the same shape as Group By, but for vertical columns.

1. How To Set Default

Set default column config in DataViewProvider:

<DataViewProvider
  controller={controller}
  defaults={{
    column: {
      propertyType: "select",
      propertyId: "category",
      sort: "asc",
      hideEmpty: false,
      showCount: true,
    },
  }}
  properties={properties}
>
  <NotionToolbar enableSettings />
  <BoardView pagination="loadMore" />
</DataViewProvider>

2. What Are The Options

Supported Property Types

TypeType-specific Option
select-
multiSelect-
statusshowAs: "option" or "group"
dateshowAs: "day", "week", "month", "year", or "relative"
textshowAs: "exact" or "alphabetical"
numbernumberRange: { range: [min, max], step }
checkbox-

Shared Options

OptionTypeDefault
sort"asc" | "desc""asc"
hideEmptybooleanfalse
showCountbooleantrue

Board Display Option

<BoardView colorColumns pagination="loadMore" />

colorColumns applies option/status colors to column backgrounds.