Skip to main content
update_table_view Change a view: its name, type, filters, sort, columns or type settings. Only what you pass changes; filters, sort and columns are replaced as a whole when given. Documents embedding the view show the change at once.

​
Parameters

​
string
required
​
string
​
string, enum: 'table' | 'list' | 'board' | 'gallery' | 'calendar' | 'timeline' | 'chart' | 'figure' | 'map' | 'checklist'
​
array<object>
Conditions, all of which must hold (any, with conjunction “or”). Each is { column, op, value } — column by name or id; a nested { conjunction, filters } groups conditions. Operators by column type — text: contains, not_contains, is, is_not, is_empty, is_not_empty; number/money: eq, neq, gt, gte, lt, lte, is_empty, is_not_empty; select/multiSelect: is, is_not, is_empty, is_not_empty (value = an option’s label); checkbox: is_checked, is_unchecked; date: is, before, after, on_or_before, on_or_after, due_within, is_empty, is_not_empty (value YYYY-MM-DD; due_within = days from today, overdue included); person: is, is_not, contains, not_contains, is_empty, is_not_empty; approval: is_approved, is_not_approved, approved_by, not_approved_by, approved_on, approved_before, approved_after; progress: is_complete, is_not_complete, gte, gt, lte, lt, eq, neq, is_empty, is_not_empty. A formula column filters as the type it returns.
​
string, enum: 'and' | 'or'
​
array<object>
[{ column, direction: ‘asc’ | ‘desc’ }], first key first.
​
array<string>
The columns to show, in any order; every other one is hidden (the identifier always shows).
​
array<string>
Alternative to columns: just these are hidden.
​
string
Board: the select column its lanes come from. Chart: the column whose values are the categories.
​
array<string>
Ids of page parameters this view must not be narrowed by — e.g. a total that should stay a total when the page’s status control is set.
​
object
For type figure — one number on a card: { aggregate, valueColumn, title, decimals, trend: up-good|up-bad|neutral, hideSource, comparison: { filters, label } (the same measure with these conditions replacing the view’s own on the same columns, drawn as a delta, e.g. last month), subtitle: { aggregate, valueColumn, filters, clear: [columns whose conditions are lifted], template: ‘of {value} this cycle’, decimals } }. The view’s filters are the figure’s scope.
​
object
For type chart: { kind: bar|line|pie, aggregate: count|sum|avg, valueColumn, title, description, caption, captionDescription, centerLabel (pie), order: value-desc|value-asc|label-asc|label-desc|row, limit (top N, the rest folds into Other) }. groupBy is required. Readers click a category to filter the page.
​
object
For type checklist — a short to-do list: { titleColumn, details: [columns], completion (a checkbox or approval column ticking writes to), due (a date column drawn as a countdown), limit }.
​
object
For type board: { cardSize: sm|md|lg, cover (image column), hideEmptyGroups, showColumnLabels }.
​
object
For type gallery: { cardSize, cover, fit: cover|contain, showColumnLabels }.
​
object
For type list: { titleColumn, layout: inline|nested, marker: decimal|disc|none }.