# Kanban

A Kanban layout shows the View's rows as cards in columns. With a post type
source each column is a term of a taxonomy, and moving a card to another
column gives the post that term. Choose **Kanban** as the layout's **Type**;
the sections below follow the layout's **Data** section, which
[Data Filtering](/docs/view/views/data-filtering.md) describes. A board loads
every row its filters match, 500 at a time.

## Columns

- **Taxonomy**: "The terms of this taxonomy will be used for the board
  categories." Each term becomes a column. With any other source this field
  lists the source's columns instead, and each value of the chosen column
  becomes a board column.
- **Allow sorting** lets people drag cards within a column and between
  columns. Without it the cards stay where they are.
- **Show add button** adds an add button to every column, which creates a
  post in that column: published when the user may publish posts of the
  post type and pending review otherwise. **Add button text** sets its label;
  when it is empty the button reads **Add post**.
- **Show uncategorized column** adds a first column for posts without a term
  in the taxonomy. Moving a card there removes its term.

Below these, each term of the taxonomy has an entry you can drag to reorder
the board's columns. Each has a **Color** and, while the board-wide add
button is off, its own **Show add button** and **Add button text**.

With a source other than a post type, only **Taxonomy** remains: the board
is read-only.

## Cards

- **Taxonomy**: "The terms of this taxonomy will be used for the card
  categories." A card shows its post's term in this taxonomy as a label, and
  the add and edit forms offer it as **Category**.
- **Show view button** shows a button on each card that opens the item
  without changing it.
- **Show edit button** shows a button on each card that opens the item for
  editing: its **Title**, **Content** and **Category**.
- **Show upvotes** shows an upvote button and count on each card. Cards with
  more upvotes sort first in their column.

Only **Taxonomy** and **Show view button** apply to other sources.

## Filter

**Show search** adds a search field that searches the cards' titles, content
and categories on the board.

## Comments

For post type sources:

- **Show comments** shows each card's comment count and its comments.
- **Allow comments** lets logged-in users add comments and edit their own.
  It needs comments to be open in **Settings > Discussion** and on the post.
  Replies nest when **Settings > Discussion** enables threaded comments, to
  the depth set there.

## How changes are saved

Every change is saved to the post at once and checked against the user's
permissions for it:

- Moving a card replaces the post's terms in the board's taxonomy with the
  column's term, which needs permission to edit the post and to assign terms
  of that taxonomy.
- A card's position is saved as the order of the column's term, so every
  board grouped by the same taxonomy shows the same order.
- A card added with an add button is a new post at the end of its column,
  with the status **Show add button** describes. It is created only for users
  who may create posts of that type and assign terms of the board's taxonomy.

## Conditions and delete

The layout's **Conditions** decide who sees its tab, and each switch above
can carry its own conditions once it is on; see
[Conditions](/docs/view/views/conditions.md). **Delete layout** removes the
layout when you save the View.