Table View

Table view puts one block on each row. Use it when you want to compare the same information across a collection and edit values without opening every block.

This guide uses a Book tag with three books. The finished table combines Heaper's built-in columns with the reusable properties from the Properties guide.

A Book collection in Table view with Title, Created, Tags, Author, Pages, Finished on, and ISBN columns

Create a Table view

Open the block that contains the collection, such as the Book tag.
Select New View in the view switcher.
Select the new view again to open its settings.
Under App type, choose Table.

A new table starts with one column: Title. Title is always present because every row represents a block.

Add built-in columns

Select + at the right end of the header, then choose a column:

Created is the date the block was created.
Updated is the date the block was last changed.
Tags shows the tags currently attached to the block.

The Book example adds Created and Tags. These values already belong to the block, so you do not need to create properties for them.

Add property columns

Select +, then Property, and choose an existing reusable property. The Book example uses:

Column	Type	Why this type fits
Author	Reference	Links to the author's block.
Pages	Number	Sorts and filters as a number.
Finished on	Date	Stores one calendar date and can also power Calendar.
ISBN	Text	Keeps hyphens, leading zeroes, and letters exactly as entered.

Select New property when the reusable property does not exist yet. Heaper creates the property and adds it as a column.

Select Tag state to show one tag as an on-or-empty column. This is useful for tags such as Favorite or Needs review. Use a Checkbox property only when both Yes and No must be stored as data.

Edit rows

Select a property cell and enter its value. The editor matches the property type:

Text and Number use direct input.
Date opens the date editor.
Choice uses the configured options.
Reference searches for another block.

Edits in the table change the same property value shown on the block. There is no separate copy for the view.

Select a title to edit it. Double-click a row to open its block.

Arrange and control columns

Drag a column header to move it. Drag its right edge to resize it.

Select a column header to open its menu. Depending on the column, you can:

Sort ascending or descending.
Configure the reusable property or open its block.
Change a Date or Checkbox display.
Pin, reset, or remove the column.

Title cannot be removed.

Filter the collection

View filters decide which blocks become rows. For the Book collection, you can require the Book tag so only books appear.

To show every block that has a reusable property set:

Open Filters and add the property block to Required, Additive, or Excluded.
Select its filter chip to open Links.
Change the link type to Properties.
Turn off Tags and Mentions when you only want property matches.

To filter by the stored value instead, open Filters, find Properties, and select Add property filter. You can then use operators that fit the type, such as Greater than for Pages or Is not empty for Finished on.

See Filters for the full filter workflow.

Sort the rows

Select a column header and choose Ascending or Descending. Empty property values appear last.

You can also open the view's Sort menu, find Properties, and choose a reusable property. This is useful when you want a property to control the order without keeping its column visible.

See Sorting for all available sort options.