Skip to content

Table Field

Attaches a table to the record: a grid of rows the editor fills in right inside the form. Slides for a slider, specs for a product, members of a team.

Settings:

SettingWhat it does
TableWhich table constructor to use
View onlyRows are listed without the create button, the row menu or editing
Sort byColumn to order rows by, menuindex by default
Sort directionAscending or descending
LimitRows per page, 20 by default

The width is forced to the full row and cannot be changed — a grid inside a narrow column is unusable.

Output is an array of rows:

html
{foreach $slides as $slide}
    <h3>{$slide.title}</h3>
{/foreach}

Rows live apart from the record, and that shows in three places

They are stored in their own table, not in the record's own value. So a table field is skipped when resource and user section values are saved, and contributes nothing to the moderation queue preview — there is no single line to show for a whole grid.

See Tables for what a table is made of and how it is stored.

© PageBlocks 2019-present