Unify Logo Footer.svg
Unify Applications
Logo
Toolbar & Views

Toolbar & Views

Logo

8 mins READ

Toolbar Overview

The toolbar ships enabled on every new table with the title "Table Title". Everything lives in one inspector panel: Inspector → Content → Add-ons → Toolbar. Remove the Toolbar add-on to hide the whole strip.

Warning: Selecting rows swaps the toolbar for the bulk-actions bar. While rows are selected on a table with bulk actions, the whole toolbar (title, search, filters, custom actions) is replaced by the bulk-actions bar until the selection is cleared.

Title & Record Count

PropertyTypeDefaultDescription
titlestring"Table Title"The heading shown at the left of the toolbar. Translatable
showTotalRecordsbooleanObject source only. When on, the count is fetched from the object automatically
totalRecordsnumber, bindableMapped source only. Bind the count yourself

Warning: The toolbar's record count badge and the pagination add-on's Total Records are two separate values. A mapped-source table that shows both needs the count bound in both places.

Standard Actions

Add any of these under Inspector → Content → Add-ons → Toolbar → Standard Actions. Each standard action can only be added once (it leaves the add menu after being added), except Quick filter which can be added multiple times.

ActionWhat the user gets
Filter and SortA combined filter builder and sort menu over the table's columns
Column visibilityA menu to show/hide columns
SearchA keyword search box
Quick filterA one-click filter pinned in the toolbar. Add one per filter you want to pin
Row heightA density toggle (Compact / Comfortable / Spacious)
ViewsThe saved-views switcher — Data Table variant only

Filter and Sort Options

PropertyDefaultDescription
Show only visible columnsfalseWhen on, only fields that are shown as columns can be filtered or sorted on
Default valueA filter applied when the table loads. Bindable
Visible FiltersFilters pinned directly in the toolbar instead of inside the filter menu
Hide Filter MenufalseRemoves the filter menu button, leaving only the pinned filters. Appears once at least one Visible Filter is set

Note: Date filtering: The data filter offers absolute date operators only (Before, After, Between, etc.) — there is no "last N days" relative operator. For relative date ranges, add a Quick filter with Filter Type = Date; it carries presets (Today, Yesterday, Last 7/15/30/90 days, This month, custom Upcoming / Previous ranges).

Search Options

PropertyDefaultDescription
Placeholder"Search"Hint text inside the search box. Translatable
Initial ValueA search term applied when the table loads. Bindable

Warning: Search is never applied in the browser. Typing in the search box only writes to {{ id.filters.search }}. An Object-backed table sends the text to the server automatically. A Mapped table does nothing with it on its own — you must bind {{ id.filters.search }} into your data source's inputs.

Quick Filter Options

A quick filter is a predefined filter rendered as its own control in the toolbar — users apply it with one click instead of opening the filter builder.

PropertyDefaultDescription
LabelText on the quick filter control. Translatable
Filter TypeDate: applies a date range. Data: applies a condition filter over a field
SourceCustomCustom: build the value in the panel. Mapped: bind it from data
ValueThe filter this control applies
Apply by defaultApplies this quick filter when the table loads

Warning: A data quick filter replaces the data filter — the two never combine. Applying it overwrites the current filter, and editing the data filter by hand clears the quick filter. If multiple quick filters are marked Apply by default, only the first date one and the first data one are applied on load.

Custom Actions

Your own buttons at the right of the toolbar. Each fires its On Click event when pressed. New actions start as visible buttons. To move one into the toolbar's overflow menu, drag it from Visible Actions to Hidden in overflow — there is no toggle inside the action's detail panel.

PropertyDefaultDescription
TypebuttonVisible actions: text button or icon-only button. Overflow entries get a menu-item variant
LabelButton text or menu entry text. Translatable
On ClickHandler that runs when pressed
Disabled / LoadingConditions to disable or show a spinner
VisibilityCondition to show/hide the action
PermissionsRestricts who sees the action

Saved Views

Views let each user save the table's current setup — filters, sort, search, page size, column widths and column order — under a name and switch between setups. Enable views by adding the Views standard action. Views are per user: one person's saved views are not visible to another.

Note: Views are only available on the Data Table block variant. The Nested Table and Group Table variants do not offer the Views standard action.

What a View Captures

CapturedDetails
FiltersThe data filter, sort order and keyword search currently applied
PageCurrent page number and page size
Column sizingColumn widths the user has dragged
Column orderColumn positions the user has rearranged

Not captured: column visibility, row selection, or pending inline edit values.

The Main View

Every table with views enabled starts with a built-in Main view. Switching to it clears every applied change back to the table's configured defaults. Main cannot be renamed, updated or deleted by users, but it can be hidden once at least one other view exists. You can relabel it and give it an icon in the Views action's options.

Views Exposed State & Methods

Binding / MethodDescription
{{ id.views }}The user's views as { id, name } pairs, in display order
{{ id.activeView.id }}ID of the view currently applied (main for the Main view)
{{ id.activeView.name }}Name of the current view
{{ id.activeView.isDirty }}True when the table's current setup differs from what the view saved
createView(name)Saves the table's current setup as a new view and switches to it
updateView(id)Overwrites the given view with the table's current setup (entire snapshot, not just filters)
deleteView(id)Deletes the given view; if active, the user lands back on Main

Views Behavior

Warning: Views cannot be pre-created or shared by the builder. Every user starts with just Main and builds their own list at runtime. There is no way to ship a table with ready-made views for all users. To give everyone the same starting state, configure the table's defaults (default filter, sort, hidden columns) instead.

Note: Signed-in users keep views across devices; anonymous users don't. For signed-in users, views live in server-side preferences and follow them across sessions. On public pages, views survive only for the current browser session.

Warning: Updating a view captures the whole current setup — filters, sort, search, page, column sizing and order. A user who only meant to save a filter tweak also saves their current column widths.

Frequently Asked Questions

Typing in the search box does nothing. Why?

On a Mapped table, the search box only writes to {{ id.filters.search }} — it does not search rows. You must bind {{ id.filters.search }} into your data source's inputs for the text to reach the query. Object-backed tables search server-side automatically over their searchable fields. The match style (exact, contains, fuzzy) is determined by the backing data store, not the table.

I created some test views while building but my users don't see them. Why?

Views are strictly per user. The views you saved while previewing belong to your account only — they are not visible to your users, and there is no builder option to publish them. Every user starts with just the Main view and creates their own saved views at runtime.

How do I show a "Today" filter button in the toolbar that users can toggle?

Add a Quick filter standard action. Set Filter Type to Date, pick the Today preset as the value, give it a Label like "Today", and optionally mark Apply by default. The user clicks it to apply the filter with one tap. Add one Quick filter per preset you want to pin — Quick filters are the only standard action you can add more than once.

Why did "Remember applied changes" get locked on after I added Views?

Views are stored through the same mechanism that remembers a user's filters and column tweaks. While the Views action is on the toolbar, that setting is locked on with a warning — it cannot be turned off until you remove the Views standard action.

My toolbar disappeared when a user selected rows. Where did it go?

If the table has bulk actions configured, selecting rows replaces the whole toolbar (title, search, filters, custom actions) with the bulk-actions bar. The toolbar returns as soon as the selection is cleared. This is by design — see Row Actions & Selection.

PageRelationship
Table OverviewThe block this toolbar belongs to
Grouping & FiltersCustom Filter Source for Mapped tables; grouped columns
Row Actions & SelectionBulk actions replace the toolbar while rows are selected