Title: Table block
Author: Milana Cap
Published: March 11, 2019
Last modified: May 29, 2026

---

# Table block

## In this article

 * [Add a Table block](https://wordpress.org/documentation/article/table-block/?output_format=md#add-a-table-block)
 * [Block toolbar](https://wordpress.org/documentation/article/table-block/?output_format=md#block-toolbar)
    - [Transform to](https://wordpress.org/documentation/article/table-block/?output_format=md#transform-to)
    - [Block-moving tools](https://wordpress.org/documentation/article/table-block/?output_format=md#block-moving-tools)
    - [Align](https://wordpress.org/documentation/article/table-block/?output_format=md#align)
    - [Change column alignment](https://wordpress.org/documentation/article/table-block/?output_format=md#change-column-alignment)
    - [Add or remove caption](https://wordpress.org/documentation/article/table-block/?output_format=md#add-or-remove-caption)
    - [Bold and italics](https://wordpress.org/documentation/article/table-block/?output_format=md#bold-and-italics)
    - [Link](https://wordpress.org/documentation/article/table-block/?output_format=md#link)
    - [More rich text options](https://wordpress.org/documentation/article/table-block/?output_format=md#more-rich-text-options)
    - [Edit table](https://wordpress.org/documentation/article/table-block/?output_format=md#edit-table)
    - [More options](https://wordpress.org/documentation/article/table-block/?output_format=md#more-options)
 * [Block settings](https://wordpress.org/documentation/article/table-block/?output_format=md#block-settings)
    - [Settings](https://wordpress.org/documentation/article/table-block/?output_format=md#settings)
    - [Advanced](https://wordpress.org/documentation/article/table-block/?output_format=md#advanced)
    - [Styles](https://wordpress.org/documentation/article/table-block/?output_format=md#styles)
    - [Color](https://wordpress.org/documentation/article/table-block/?output_format=md#color)
    - [Typography](https://wordpress.org/documentation/article/table-block/?output_format=md#typography)
    - [Dimensions](https://wordpress.org/documentation/article/table-block/?output_format=md#dimensions)
    - [Border](https://wordpress.org/documentation/article/table-block/?output_format=md#border)
 * [Demo](https://wordpress.org/documentation/article/table-block/?output_format=md#demo)
 * [Changelog](https://wordpress.org/documentation/article/table-block/?output_format=md#changelog)

[ Back to top](https://wordpress.org/documentation/article/table-block/?output_format=md#wp--skip-link--target)

[Go to the List of Blocks](https://wordpress.org/support/article/blocks/)

Use the Table block to easily create a table in any post or page. 

![Table block in editor](https://wordpress.org/documentation/files/2019/03/table-
block-example-1024x351.jpg)

## 󠀁[Add a Table block](https://wordpress.org/documentation/article/table-block/?output_format=md#add-a-table-block)󠁿

To add the Table block to a page, click the** Add block** button to open the block
inserter pop-up window and choose the Table block.

You can also use the keyboard shortcut /table to quickly insert a Table block. Remember
that tables are best used for tabulated data rather than page design. For example,
if you want columns, you can use the [Columns block](https://wordpress.org/documentation/article/columns-block/).

[Detailed instructions on adding blocks can be found here.](https://wordpress.org/documentation/article/adding-a-new-block/)

## 󠀁[Block toolbar](https://wordpress.org/documentation/article/table-block/?output_format=md#block-toolbar)󠁿

![Table block toolbar](https://wordpress.org/documentation/files/2019/03/table-block-
toolbar-inside-text.png)

Each block has its own block-specific controls that allow you to manipulate the 
block right in the editor. If you hover over the buttons, tooltips will tell you
what is behind the buttons, and also show you keyboard shortcuts when available.

The block toolbar for the paragraph block shows these buttons:

 * Transform to
 * Block-moving tools
 * Align
 * Change column alignment
 * Add or remove caption
 * Bold and Italics
 * Link
 * More Rich Text controls
 * Edit table
 * Options

### 󠀁[Transform to](https://wordpress.org/documentation/article/table-block/?output_format=md#transform-to)󠁿

![Transform options for the table block](https://wordpress.org/documentation/files/
2019/03/table-block-transforms-1024x579.png)

Click on the “Transform” button to convert the Table block into a “Group”, “Details”,
or “Columns” block. It’s also possible to change the style of a table to “Default”
or “Stripes”.

### 󠀁[Block-moving tools](https://wordpress.org/documentation/article/table-block/?output_format=md#block-moving-tools)󠁿

![Block moving tools highlighted on the block toolbar](https://wordpress.org/documentation/
files/2019/03/table-block-toolbar-moving-tools.png)

Use the block-moving tools to move the Table block.

The **drag** or **six dots** icon allows you to freely reposition the block anywhere
within the editor by holding the icon and dragging it to the new location.

You can also use the **arrow icons** to move the block up or down within the group
of nested blocks or when there are multiple blocks.

[Detailed instructions on moving a block within the editor can be found here](https://wordpress.org/support/article/moving-blocks/)

### 󠀁[Align](https://wordpress.org/documentation/article/table-block/?output_format=md#align)󠁿

![Block alignment tool for the table block](https://wordpress.org/documentation/
files/2019/03/table-block-align-1024x539.png)

Use the change alignment tool to align the Table block. Choose one of the following
options:

 * **None – **leaves the block the current size.
 * **Wide width – **increase the width of the block beyond the content size.
 * **Full width – **extend the block to cover the full width of the screen.
 * **Align left – **aligns the block left.
 * **Align center – **aligns the block to the center.
 * **Align right – **aligns the block right.

The “Wide width” and “Full width” alignment settings must be enabled by your WordPress
theme. 

### 󠀁[Change column alignment](https://wordpress.org/documentation/article/table-block/?output_format=md#change-column-alignment)󠁿

![Column alignment tool for the table block](https://wordpress.org/documentation/
files/2019/03/table-column-alignment-1024x361.png)

Use the change column alignment tool to align the columns of a Table block. Choose
one of the following options:

 * **Align column left – **aligns the column left.
 * **Align column center – **aligns the column to the center.
 * **Align column right – **aligns the column right.

### 󠀁[Add or remove caption](https://wordpress.org/documentation/article/table-block/?output_format=md#add-or-remove-caption)󠁿

![](https://wordpress.org/documentation/files/2019/03/table-block-toolbar-caption.
png)

Use the add or remove caption option to toggle the caption of the Table block. You
can apply bold or italic formatting to captions, or create a link.

### 󠀁[Bold and italics](https://wordpress.org/documentation/article/table-block/?output_format=md#bold-and-italics)󠁿

![Block toolbar with bold and italics options highlighted](https://wordpress.org/
documentation/files/2019/03/table-block-toolbar-inside-text-bold-itallic.png)

The Bold and Italics formatting options are used to customize the text in the Table
block. You can also use keyboard shortcuts to enable these text formatting:

 * **Ctrl + B** or **Command + B** to bold the text.
 * **Ctrl + I** or **Command + I** to italicize the text.

### 󠀁[Link](https://wordpress.org/documentation/article/table-block/?output_format=md#link)󠁿

Use the link option to add a link to the table. It’s also possible to set it to 
open the link in a new tab.

[Read about more link editing options.](https://wordpress.org/documentation/article/link-editing/)

### 󠀁[More rich text options](https://wordpress.org/documentation/article/table-block/?output_format=md#more-rich-text-options)󠁿

The drop-down menu to the left of the [More options menu](https://wordpress.org/documentation/article/more-options/)
contains a range of additional rich text editing options such as highlighting, inline
code, strikethrough, and more.

[Read about more rich text editing options.](https://wordpress.org/documentation/article/more-text-editing-overview/)

### 󠀁[Edit table](https://wordpress.org/documentation/article/table-block/?output_format=md#edit-table)󠁿

![Edit table option for the table block](https://wordpress.org/documentation/files/
2019/03/table-block-edit-table-1024x565.png)

Use the edit table option to quickly manage rows and columns. It’s possible to insert
a row or column before, insert a row or column after, and delete a row or a column.

### 󠀁[More options](https://wordpress.org/documentation/article/table-block/?output_format=md#more-options)󠁿

The Options menu represented by three vertical dots on the far right of the toolbar
gives you more features such as the ability to duplicate or remove the block.

[Read about these and other settings.](https://wordpress.org/documentation/article/more-options/)

## 󠀁[Block settings](https://wordpress.org/documentation/article/table-block/?output_format=md#block-settings)󠁿

![Block settings panel](https://wordpress.org/documentation/files/2019/03/block-
settings-button.png)

The block settings panel contains customization options specific to the block. To
open it, select the block and click the Settings button next to the Publish or Save
button.

Here are the options for the Table block:

### 󠀁[Settings](https://wordpress.org/documentation/article/table-block/?output_format=md#settings)󠁿

![Table block settings expanded panel](https://wordpress.org/documentation/files/
2019/03/table-block-settings.png)

The settings section provides three possible options:

**Fixed width table cells** – means rather than adapting the column widths to the
content of the table, all columns will be equal width. This option is also available
when the Table block is still in the placeholder state. As of version 6.6, this 
option is turned on by default.

![Settings are defaulted to fixed width table cells for a new Table block](https://
wordpress.org/documentation/files/2019/03/table-fixed-width-table-cells-1024x392.
png)

**Header section** – adds a header section to the table.

![Table with a header section](https://wordpress.org/documentation/files/2023/03/
header.png)

**Footer section** – adds a footer section to the table.

![Table with a footer section](https://wordpress.org/documentation/files/2023/03/
footer.png)

### 󠀁[Advanced](https://wordpress.org/documentation/article/table-block/?output_format=md#advanced)󠁿

The Table block provides the following Advanced settings options: HTML anchor, Additional
CSS Class(es), and Styles.

[Learn more about advanced settings](https://wordpress.org/documentation/article/advanced-settings-overview/)

### 󠀁[Styles](https://wordpress.org/documentation/article/table-block/?output_format=md#styles)󠁿

![Table block styles expanded panel](https://wordpress.org/documentation/files/2019/
03/table-block-styles-369x1024.png)

Choose between the “Default” and “Stripes” styles for your table. The “Default” 
style has a plain background and borders around the cells. The “Stripes” style has
alternating row background colors.

The final appearance of the table may vary depending on your theme.

### 󠀁[Color](https://wordpress.org/documentation/article/table-block/?output_format=md#color)󠁿

The Table block provides Color settings options to change the text and background
colors.

[See this guide for more information about changing colors.](https://wordpress.org/documentation/article/colors-settings-overview/)

### 󠀁[Typography](https://wordpress.org/documentation/article/table-block/?output_format=md#typography)󠁿

The Table block provides typography settings to change the font family, size, appearance,
line height, letter case, letter spacing, and decoration.

[Get more details about changing typography settings.](https://wordpress.org/documentation/article/typography-settings-overview/)

### 󠀁[Dimensions](https://wordpress.org/documentation/article/table-block/?output_format=md#dimensions)󠁿

The Table block provides dimension settings options to change padding and margin
size.

For details refer to this support article: [Dimension settings overview](https://wordpress.org/documentation/article/dimension-controls-overview/)

### 󠀁[Border](https://wordpress.org/documentation/article/table-block/?output_format=md#border)󠁿

The Table block provides border settings options to add border color, width, and
radius.

For details refer to this support article: [Border settings overview](https://wordpress.org/documentation/article/border-settings-overview/)

## 󠀁[Demo](https://wordpress.org/documentation/article/table-block/?output_format=md#demo)󠁿

## 󠀁[Changelog](https://wordpress.org/documentation/article/table-block/?output_format=md#changelog)󠁿

 * Updated 2026-05-25 (props @kjoyner @awetz583)
    - Updated “Advanced” section to refer to new overview page
 * Updated 2026-02-20 (props to @bph, @leonnugraha, @PaulHHM, @awetz583)
    - Added “How to add a Table block” heading
    - Updated language for fixed width cells
    - Added information for caption button
    - Updated screenshots, video and text formatting
 * Updated 2023-08-09
    - Replaced the link section with short summary linking to new dedicated page.
 * Updated 2023-06-08
    - Replaced “More rich text options” section with short summary linking to new
      dedicated page for rich text editing options.
 * Updated 2023-03-07
    - Revised formatting for the whole article
    - Added detailed information about each block toolbar button
    - Updated all the screenshots for 6.2
 * Update 2022-04-20
    - Update screenshots to 5.9

## Was this article helpful? How could it be improved? 󠀁[Cancel reply](https://wordpress.org/documentation/article/table-block/?output_format=md#respond)󠁿

[Log in to submit feedback](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fwordpress.org%2Fdocumentation%2Farticle%2Ftable-block%2F&locale=en_US).
If you need support with something that wasn't covered by this article, please post
your question in the [support forums](https://wordpress.org/support/forums/).

First published

March 11, 2019

Last updated

May 29, 2026