Skip to main content

Kanban View

Configuration reference: Kanban

Overview​

The Kanban view organizes records into vertical columns (lanes) based on a field value. Cards can be dragged between lanes to update the grouping field — perfect for workflow tracking, status management, and task boards.

Columns and swimlanes​

Field-based grouping​

The most common setup groups cards by a Select column (e.g., "Status" with values "To Do", "In Progress", "Done"). Each unique value becomes a lane.

Configure grouping with:

  • groupBy — The column to group by
  • groupOrder — Custom lane ordering
  • hideEmptyGroups — Hide lanes with no cards
  • collapsedGroups — Lanes to collapse by default
  • groupVisibilityConditions / swimlaneVisibilityConditions — Conditions that restrict the values of each axis, on a Seleção ligada (linked select) axis (see Showing only some lanes)

Showing only some lanes​

When the axis is a linked select column, the view config offers Colunas visíveis and Swimlanes visíveis: conditions on the linked table that decide which axis values open a lane. For example, a board with swimlanes by Colaborador and the condition Setor equal to Desenvolvimento shows only that sector's swimlanes, and stays right when people join or leave the team.

The conditions use the same columns, operators and value fields as "Filtrar opções" on the linked select; several conditions combine with AND. With no conditions, every value opens a lane.

ToolWhat it does
FiltersChooses which records enter the board.
Hide empty groupsHides lanes that currently have no records.
Colunas / Swimlanes visíveisChooses which axis values open a lane, with or without records.

A lane hidden by a condition takes its cards with it; to keep the records visible, use Filters. Lanes for records with no value on the axis ("Sem valor", "Sem grupo") are never hidden by these conditions. The axis's manual order list shows only the values the conditions let through.

Weekday-based grouping​

For date-driven workflows, the kanban can group by weekdays:

RangeDescription
Current weekLanes for Monday through Sunday of the current week
Next weekLanes for next week's days
Both weeksCurrent and next week combined
Custom rangeSpecify start and end dates

Configure with groupType: "weekdays", dateField, and weekRange.

Drag and drop​

Drag a card from one lane to another to update its grouped field value. For example, dragging a card from "To Do" to "In Progress" automatically updates the record's status field.

Cards can also be reordered within a lane. The sort order within groups is configurable via sortWithinGroups.

Card display​

Configure which fields appear on each card using displayFields. Cards show the configured fields as a compact summary. Conditional formatting applies color to cards based on field value conditions.

Configuring card fields​

The Campos ("Fields") tab in the view configuration splits fields into two lists:

  • No cartão ("On the card") - the chosen fields, in the order they render on the card.
  • Disponíveis ("Available") - the remaining eligible fields.

The order in "No cartão" is the render order on the card - drag the grip to reorder. The 1st field renders as the card title (primary style), the 2nd as secondary text, and the rest as meta lines.

Toggling a field on in "Disponíveis" appends it to the end of "No cartão". Toggling a field off removes it without disturbing the order of the others.

With no fields chosen, the card automatically shows the first 3 non-hidden columns.

Users can still hide fields at runtime from the view menu - this filters the displayed list but preserves the configured order of the remaining fields.

Toolbar​

  • Search — Full-text search across all cards
  • Filter — Advanced filter panel
  • Group — Change the grouping column
  • Export — Export kanban data
  • Collapse — Collapse or expand all lanes at once
  • Add — Create new records (appears within each lane)
  • Selection — Select multiple cards for bulk actions

In Configurar vista › Comportamento › Formulário you choose which form opens for Add/Edit and the dialog size (see When opening a record).