> For the complete documentation index, see [llms.txt](https://docs.diaflow.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.diaflow.io/tables/table-views.md).

# Table Views

Table Views in Diaflow Tables allow teams to visualize and interact with the same underlying records across different formats without duplicating data. Each sheet supports multiple independent views, each maintaining its own configuration for filters, sorting, grouping, hidden fields, and display styling.

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2Fdvhu4QxJFRo0hxfAMgmI%2Ftable%20views%20thumbnail.webp?alt=media&#x26;token=6d67bfc3-e3ac-4ab2-9f8a-3f93f2c8c16d" alt=""><figcaption></figcaption></figure>

***

## 1. Core Concepts & Architecture

Understanding how Table Views operate ensures smooth collaboration and data integrity:

* **Underlying records are shared**: Views are lenses over the exact same data store. Editing a record in any view updates it everywhere immediately. Deleting a view deletes only that view configuration tab; it never deletes underlying records.
* **Every member can manage views**: View management is shared among all workspace members who have access to the table. Every member can create, rename, duplicate, reorder, and delete views, adjust view controls, and edit records. Any saved change to a view's settings is visible to all members.
* **Shared view settings**: Filters, sorting, grouping, hidden fields, record colors, card display fields, and layout configurations are saved per view for all collaborators.
* **Personal session preferences**: A few settings remain strictly personal to each user:
  * **My favorites** list.
  * The last opened view on each sheet (remembered across devices).
  * The search query in the toolbar.
  * The current date range on screen in Calendar and Timeline.
  * Zoom adjustments made with a trackpad.
* **Automatic vs explicit saving**: Most configuration changes save automatically in real time. Exceptions include **Filter** and **Sort** (which require clicking **Apply filter** or **Apply sort**) and the record side panel (which requires clicking **Save**).
* **Persistent default**: Every sheet always keeps at least one Grid view. The last remaining Grid view cannot be deleted.

***

## 2. Supported View Types

Diaflow Tables provides 5 primary view types to accommodate diverse business workflows:

| View Type    | Best For                                                                                    | Required Setup                                                  |
| ------------ | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| **Grid**     | Spreadsheet-style data entry, inline calculations, multi-level grouping, and summary totals | None (default view)                                             |
| **Kanban**   | Agile task boards, sales stages, hiring pipelines, and owner-based handoffs                 | One Single select or single-person Assignee field               |
| **Calendar** | Deadline tracking, editorial schedules, event rosters, and multi-day milestones             | One Date field (optional second Date field for duration ranges) |
| **Timeline** | Gantt-style planning, phase schedules, resource roadmaps, and duration bars                 | One Date field (optional second Date field for bar spans)       |
| **Gallery**  | Visual asset catalogs, employee directories, product cards, and portfolio reviews           | None (an Attachment field is required for card covers)          |

***

## 3. Managing Views via Sidebar & Mobile

### Views Sidebar (Desktop)

* The sidebar is closed by default upon opening a table.
* Click the **view tag** on the far left of the table header (displaying a sidebar icon followed by the current view icon and name) to expand or collapse the sidebar.
* **Sidebar Layout**:
  * Top search box (**Find a view**) with a round **+** button to create a view.
  * **My favorites**: Personal list of bookmarked views.
  * **Views count list**: Shows every other view in the sheet with distinctive colored icons: Grid (blue), Kanban (red), Calendar (green), Timeline (violet), Gallery (brown).
* Search matches view names regardless of letter case.

### Views on Mobile (Screen width below 768 px)

On narrow screens, the sidebar is replaced by a view switcher button with a chevron. Tapping this button opens a bottom sheet titled **Switch view**, equipped with a **Search a view** input and a **+** button.

### Switching Views

* Click any view in the sidebar or press **Enter** when focused.
* Active search text in the toolbar resets automatically when switching views.
* Diaflow remembers the last viewed tab per sheet across all your devices.

### Creating a View

* Click the round **+** button next to **Find a view**.
* Select **Grid**, **Kanban**, **Calendar**, **Timeline**, or **Gallery**.
  * Selecting **Grid** creates the view immediately named **Grid view** (or numbered sequentially if that name is taken) and focuses the label for immediate renaming.
  * Selecting any other view type opens its respective setup modal.
* View names support up to 100 characters and must be unique within the sheet.

### View Menu Options

Hovering over any view item in the sidebar reveals a three-dot menu (**⋯**):

* **Add to "My favorites" / Remove from "My favorites"**: Bookmarks the view in your personal favorites section.
* **Rename**: Edits the view label inline. Press **Enter** or click outside to confirm; press **Esc** to cancel.
* **Duplicate**: Clones the view configuration into a new tab named `<name> copy` immediately below the original.
* **Delete**: Removes the view configuration for all members after confirmation. The last remaining Grid view on a sheet cannot be deleted.

### Reordering Views

Drag any view vertically within the sidebar list to reposition it. Keyboard users can press **Space** to pick up a view item, use the arrow keys to adjust its position, and press **Space** again to drop. The updated tab order is shared across all workspace members.

***

## 4. Universal Toolbar Controls

All view types share a consistent top control bar:

* **Filter**: Supports up to 49 conditional rules using `AND` / `OR` logic. Saved only after clicking **Apply filter**.
* **Sort**: Orders records by a chosen field. Saved only after clicking **Apply sort**. (Kanban and Timeline do not feature a Sort button).
* **Color**: Opens the record coloring popover with options for **By field** or **By conditions**.
* **Search**: Searches visible records in real time without accent sensitivity.

***

## 5. System Limits Reference

| Feature                          | Operational Limit                               |
| -------------------------------- | ----------------------------------------------- |
| Views per sheet                  | No limit                                        |
| View name length                 | Up to 100 characters (unique per sheet)         |
| Filter conditions                | Up to 49 conditions per view                    |
| Multi-level grouping (Grid)      | Up to 3 levels                                  |
| Groups displayed (Grid)          | First 2,000 groups                              |
| Kanban stacks displayed          | First 200 stacks                                |
| Cards loaded per stack / Gallery | 50 cards initially (incremental scroll loading) |
| Calendar records per range       | First 2,000 records                             |
| Timeline bars displayed          | First 2,000 bars                                |
| Calendar date field pairs        | Up to 10 pairs                                  |
| Column width                     | 20 px to 2,000 px                               |

## Next Steps

Explore detailed setup guides and configuration options for each view type:

* [**Grid View**](https://docs.diaflow.io/tables/table-views/grid-view.md) - Spreadsheet editing, multi-level grouping, column tinting, and keyboard navigation.
* [**Kanban View**](https://docs.diaflow.io/tables/table-views/kanban-view.md) - Card stacks, stage transitions, and WIP controls.
* [**Calendar View**](https://docs.diaflow.io/tables/table-views/calendar-view.md) - Date scheduling, multiple date pairs, and unscheduled drawers.
* [**Timeline View**](https://docs.diaflow.io/tables/table-views/timeline-view.md) - Gantt duration planning, zoom intervals, and milestone tracking.
* [**Gallery View**](https://docs.diaflow.io/tables/table-views/gallery-view.md) - Visual card grids, image covers, and content cards.
* [**Color Records & Rules**](https://docs.diaflow.io/tables/table-views/color-records-view-rules-and-faq.md) - Conditional formatting rules and system notifications reference.
