Getting startedView Working with views for a comprehensive guide to creating and managing views.
Supported view types
| Type | Description |
|---|---|
table | Rows-and-columns spreadsheet layout. |
board | Kanban board grouped by a property. |
calendar | Calendar layout grouped by a date property. |
timeline | Gantt-style timeline layout. |
gallery | Card grid with cover images. |
list | Simple list layout. |
form | Form view for data entry. |
chart | Chart visualization. |
map | Map view with location pins. |
dashboard | Multi-widget dashboard containing other views. |
View-specific
configuration is available for all view types except dashboard. Dashboard views use rows to define their layout instead. See Working with views for configuration details per view type.Object fields
The response of View APIs like Retrieve a view contains view objects with the following fields:| Field | Type | Description |
|---|---|---|
object | "view" | Always "view". |
id | UUID | The ID of the view. |
parent | Object | The parent database. Contains type: "database_id" and database_id. |
data_source_id | String | null | The ID of the data source this view is scoped to, or null for dashboard views. |
name | String | The display name of the view. |
type | String | One of the supported view types. |
filter | Object | null | The filter applied to this view, or null if no filter is set. |
sorts | Array | null | The sorts applied to this view, or null if no sorts are set. |
configuration | Object | null | View-specific layout configuration, discriminated by type. See Working with views for details. |
created_time | String | ISO 8601 timestamp when the view was created. |
created_by | Object | null | Partial user who created the view. |
last_edited_time | String | ISO 8601 timestamp when the view was last edited. |
last_edited_by | Object | null | Partial user who last edited the view. |
url | String | Deep link to the view in Notion. |
dashboard_view_id | String | Only present for widget views inside a dashboard. The ID of the parent dashboard view. |