region

The region container defines a secondary grid that can receive tiles via the in name placement syntax. This page consolidates the rules, options, and examples for show region, including headers, footers, and the special top and bottom regions.

Table of contents

Basic syntax

Use show region to create a named grid and place tiles inside it with in name.

overview = show region { ..4, ..7 }

show scalar "2024" { .., ..2 in overview } with 13370
show scalar "2025" { .., 4..5 in overview } with 42000

The in dash part is optional. When omitted, the tile is placed on the dashboard grid.

Region identifiers and ordering

Region identifiers must be unique within a script and cannot be reassigned. It is recommended to define regions before the tiles that reference them, but the layout editor tolerates placing show region after those tiles.

show scalar "2024" { .., ..2 in overview } with 13370
show scalar "2025" { .., 4..5 in overview } with 42000

overview = show region { ..4, ..7 }

Regions cannot be nested inside other regions.

Headers and footers

Regions can include a header or footer by using show region .. with and adding show header or show footer inside the block. Only headers and footers are allowed inside that block.

summary = show region { ..2, ..9 } with
  show header "Yearly Revenue"

show scalar "2024" { .., ..2 in summary } with 13370
show scalar "2025" { .., 4..5 in summary } with 42000

Headers and footers consume space outside the inner grid. The header takes two rows and adds an empty row before the inner grid.

Card and nocard regions

Regions are cards by default, which adds padding around the inner grid. Use nocard to remove the card and its padding.

compact = show region { ..2, ..5 nocard }

show scalar "A" { .., ..2 in compact } with 1
show scalar "B" { .., 4..5 in compact } with 2

Headers and footers are not allowed in nocard regions.

Special regions

Every script provides dash (the default grid) plus two special regions: top and bottom. These regions are sticky, limited to 10 rows, and shrink to the content they contain.

show label "Footer" { .., ..3 in bottom }

If no tile is placed in top or bottom, that region is not displayed. If top is empty, the dashboard shows the title and either a submit or slices tile.