Skip to main content

Add a Table Box in the Editor

Learn how to create tables—such as pricing charts, business hours, and plan comparisons—directly in the Design Editor. This guide covers basic table operations, including adding and reordering rows and columns, setting headers, and merging cells.

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 (<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:

  1. Open the page where you want to add the table in the Design Editor.

  2. Open [Add] on the left sidebar.

  3. Under [Basic], click [Table] (or drag and drop it onto the canvas).

  4. 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

auto (fits content)

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:

  1. Select the Table Box.

  2. Hover over the border between two rows or columns.

  3. 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

  1. Select the row or column using its handle.

  2. 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

  1. Select the handle of the row or column you want to move.

  2. Drag the handle to the target position.

  3. 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]

⌘ + C

Paste

[Paste row] / [Paste column]

⌘ + V

Cut

—

⌘ + X

Duplicate

[Duplicate row] / [Duplicate column]

⌘ + D

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:

  1. Select the entire Table Box.

  2. Open [Table] in the right panel.

  3. Under [Header rows], choose how many rows from the top should be headers.

  4. 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:

  1. Select one of the cells you want to merge.

  2. Hold Shift (⇧) and click the other cells (or use Shift + Arrow keys to expand the selection).

  3. 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:

  1. Check the layout in Live Preview.

  2. Update your site from the Publish panel.

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.

Related articles

Did this answer your question?