With a Table Box, you can build row-and-column tables directly in the Design Editor. On your published site, it outputs as a standard HTML table (<table>), ensuring search engines and screen readers recognize the structure.
Adding or reordering rows and columns takes a single action, and cell dimensions automatically align to the grid. Unlike tables built by combining individual boxes, Table Boxes stay intact when you update their content.
This article explains how to add a Table Box and perform basic operations on rows, columns, headers, and cells. For styling or importing external data, see the related articles.
The Design Editor's Table Box is separate from tables inserted into Studio CMS articles. For CMS content, see Add a Table inside a Studio CMS Rich Text Property.
Table Box vs. Box-Built Tables
Table Boxes are built specifically for creating and maintaining structured tables.
Feature | Box-Built Table | Table Box |
Creation | Combine boxes horizontally and vertically | Add a Table Box and adjust rows/columns |
Updates | Rebuild layout whenever adding rows or columns | Add, delete, or reorder rows and columns in one action |
Published Output | Not recognized as a table | Output as a semantic HTML table ( |
You can place text, images, buttons, and boxes inside cells, and edit them just like standard elements.
Add a Table Box
Add a Table Box from the [Add] panel:
Open the page where you want to add the table in the Design Editor.
Open [Add] on the left sidebar.
Under [Basic], click [Table] (or drag and drop it onto the canvas).
A 3×3 table is added to the page.
A newly added table starts with the following default settings:
Property | Default Value |
Rows & Columns | 3 rows × 3 columns |
Headers | None |
Width |
|
Cells | 8px padding, 1px gray border on all sides |
Cell Content | Text element ("Type Something") |
Tip: Use a pre-designed table
You can also insert pre-styled tables from [Add] > [Parts]. Look under the Table tag to find 13 presets.
Select Table Elements
Clicking a Table Box cycles through its hierarchy: Entire Table Box → Cell → Element inside the cell.
Action | Selected Element |
Click the Table Box | Entire Table Box |
Click again | Cell |
Click the selected cell again | Element inside the cell |
Click a top column handle (●) | Column |
Click a left row handle (●) | Row |
You can also navigate using keyboard shortcuts when a cell is selected:
Arrow keys: Move to an adjacent cell.
Enter: Select the element inside the cell.
Esc: Move up one level in the selection hierarchy.
Tip: Select nested elements directly
Hold ⌘ (Mac) or Ctrl (Windows) and click to directly select the deepest element under your cursor. See Keyboard Shortcuts for more controls.
In the Layers panel, the structure appears in three levels: Table Box → Cell → Content.
Add, Delete, and Reorder Rows & Columns
You can manage rows and columns directly on the canvas, via the right-click menu, or from the right panel.
Add Rows and Columns
Add rows or columns using the [+] icon on cell borders:
Select the Table Box.
Hover over the border between two rows or columns.
Click the [+] icon that appears.
New columns inherit the style (background, border, width) of the column to their left; new rows inherit the style (background, border, height) of the row above them.
You can also add rows and columns using these methods:
Method | Action |
End bar | Hover over the last row or column and click the blue bar that appears. |
Right-click | Right-click a cell or handle and select [Add row above], etc. |
Right panel | Click [+] next to [Rows] or [Columns] under [Table]. |
Delete Rows and Columns
Select the row or column using its handle.
Right-click and choose [Delete row] or [Delete column], or press Delete.
Note: No confirmation prompt is shown
Rows and columns—including those with content—are deleted immediately without confirmation. Press ⌘ + Z (Mac) or Ctrl + Z (Windows) to undo. You cannot delete the last remaining row or column.
Reorder Rows and Columns
Select the handle of the row or column you want to move.
Drag the handle to the target position.
Drop it when the blue guide line appears.
If you drop it where no guide line is visible, the move is canceled. Rows or columns containing merged cells cannot be dragged.
Copy and Duplicate Rows & Columns
Copy or duplicate rows and columns via the right-click menu or keyboard shortcuts (use Ctrl instead of ⌘ on Windows)
Action | Right-Click Menu | Shortcut |
Copy | [Copy row] / [Copy column] |
|
Paste | [Paste row] / [Paste column] |
|
Cut | — |
|
Duplicate | [Duplicate row] / [Duplicate column] |
|
Copied rows and columns can only be pasted within the same project. To reuse a table in another project, copy the entire Table Box.
Set Header Rows and Columns
Configure header rows and columns in the right panel:
Select the entire Table Box.
Open [Table] in the right panel.
Under [Header rows], choose how many rows from the top should be headers.
Under [Header columns], choose how many columns from the left should be headers.
You can set up to 5 header rows and 5 header columns. Hovering over an option highlights the target cells in yellow on the canvas.
Header cells are output as semantic <th> tags on your published site, with accessibility associations automatically configured for screen readers.
Note: Headers must be consecutive from the top or left edge
You cannot set individual cells or middle rows/columns as headers. If a table requires headers partway through, split it into two separate Table Boxes.
Merge Cells
Merge cells to group pricing tiers or create multi-level headers:
Select one of the cells you want to merge.
Hold Shift (⇧) and click the other cells (or use Shift + Arrow keys to expand the selection).
Right-click and choose [Merge cells], or press ⌘ + M (Mac) / Ctrl + M (Windows).
To unmerge, right-click and select [Unmerge cells], or press ⌘ + Shift + M (Mac) / Ctrl + Shift + M (Windows). When unmerged, the content from the merged cell is copied into each individual cell.
Note: Only the top-left cell's content is kept
When merging cells, content in all cells except the top-left one is deleted. Move any content you want to keep before merging.
Cells cannot be merged if:
The selection does not form a rectangle.
The selection mixes header cells and regular cells.
The selection mixes sticky rows/columns and regular rows/columns (see Adjust Table Design and Size [URL TBD])
Publish Your Changes
Changes to a Table Box will not appear on your live site until you publish:
Check the layout in Live Preview.
Table Box Limits
Table Boxes have the following limits:
Item | Limit |
Rows | Up to 50 regular rows (55 total including header rows) |
Columns | Up to 20 columns (including header columns) |
Header rows / columns | Up to 5 each |
You cannot convert an entire Table Box into a list or bind Studio CMS data directly to the table itself. However, you can connect CMS data to individual text or image elements placed inside cells, just like standard elements.
