---
title: "Views"
space: "Frappe Framework"
url: "https://www.prilk.com/docs/frappe-framework/views"
updated: "2026-05-14"
---

## Different Views

Every DocType in Frappe gets multiple view modes — pick the one that matches the task. Switching between them is one click in the list-view toolbar.

### Available views

| View | What it shows | Best for |
|---|---|---|
| **List** | Tabular rows with filters, sort, bulk actions | Default — scanning many records |
| **Report** | Grouped totals, pivots, customizable columns | Analysing data, ad-hoc reporting |
| **Calendar** | Records placed on a date grid (month / week / day) | Anything time-based: Events, Sales Orders by delivery date |
| **Kanban** | Cards in columns by a Select field (e.g., status) | Workflow boards — Leads, Tasks, Opportunities |
| **Gantt** | Horizontal bars on a timeline | Project planning — Tasks, Project Milestones |
| **Image** | Grid of records with their attached image | Item catalogs, employee directories |
| **Tree** | Hierarchical parent-child structure | Chart of Accounts, BOM, Customer Groups |
| **Dashboard** | Charts, number cards, recent activity | Module landing pages |

### Switching views
On any list page, the **view selector** sits in the top-right toolbar. Available views depend on the DocType — Kanban needs a Select field; Calendar needs a Date / Datetime field.

### Per-user defaults
Your last-used view per DocType is remembered. Open Sales Invoice in Kanban once and Frappe lands you there next time. Reset by opening the **List View** explicitly.

### Saving filtered views
Apply filters, sort, and column selection, then **Menu → Save Filter** to keep the configuration. Saved filters appear in the filter dropdown for later one-click use.

### Customising the list
- **Settings → List Settings** — choose visible columns
- **Settings → Edit Settings** — change default sort, page size
- Re-order columns by dragging the header

### Kanban specifics
Kanban needs a "kanban column field" — usually `status`. Set up via **Kanban Board** DocType (one board per saved configuration). Multiple Kanban Boards can exist per DocType for different team workflows.

### Calendar specifics
Calendar reads two fields: start (required) and end (optional). Configure via the DocType's `start_date_field` and `end_date_field` properties. Most date-bearing DocTypes work out of the box.

### Where the Form view fits in
Clicking any record opens its **Form view** — the detail page with all fields, child tables, comments, attachments, version history. Form view isn't selectable from the list; it's how you edit one record.