Group Block

The Group block allows you to group different blocks together and customize to your liking, including setting custom background colors, spacing, and more.

Example Group Block

Group block with columns, heading, paragraph, image and button blocks.
Group block with columns, heading, paragraph, image and button blocks.

To add a group block, click on the Block Inserter icon.

Adding the group block to a post or page

You can also type /group and hit enter in a new paragraph block to add one quickly.

Detailed instructions on adding blocks

Block Toolbar

Most blocks have their own block-specific controls that allow you to manipulate the block right in the editor. The group block offers standard block options as well as full width and wide width options (if the theme supports these alignment styles).

The “Group” block shows three buttons in addition to the “Group” block icon.

  • Moving handles
  • Change alignment
  • More options

Moving handles

Moving handles for the group block

The up and down arrow icons can be used to shift a block up and down in your document. Detailed instructions on moving a block within the editor can be found here.

Change alignment

Image to change alignment for the group block

Wide width – Increase the width of the post beyond the content size.

Full width – Extend the block to cover the full width of the screen(if supported by your site’s theme).

More options

These controls give you the option to copy, duplicate, and edit your block as HTML.

Read about these and other settings.

Editing the block

The nice thing about the Group block is that you can add any other blocks inside the group block and create a layout of your own. To add blocks to the Group block, click on the add inserter icon inside the Group Block.

Adding content

Inside the group block, you can add a columns block, cover block or any other available block to create the layout of your choice.

Adding content to the group block

The group block shown here has columns, heading, paragraph, image and button blocks.

Block Settings

Every block has specific options in the editor sidebar in addition to the options found in the block toolbar. If you do not see the sidebar, simply click the ‘cog’ icon next to the Publish button.

Block settings for the group block

Note that since the group block has the ability to embed other blocks, if you click specifically on one of the blocks, the settings in the sidebar will change according to the block you added to the group block (e.g. if you added an image inside the group block, when you click on the image the sidebar will display the options from the image block settings).

Image showing block settings for the group block


This is an advanced option that allows you to add custom content widths to the overall Group block for all blocks assigned to the center or wide columns. In many cases, you won’t need to use this option. When you toggle this option on, it allows the Group block to inherit the options set by your theme. When it’s toggled off, you can customize to your liking.

This article provides details about layout settings. 


When the group block is selected, you can see the color settings in the sidebar. You can select the text, background, and link colors to your liking.

See this guide for more information about changing colors.


This option allows you to set a border around the Group block, including the color, the width, radius, and the style of the border.

Learn more about border settings.


The option to control block spacing and padding is enabled for the Group block. You can read more about these settings in the 

Learn more about dimension controls.


The “Advanced” tab lets you add HTML anchor and CSS class(es) to your block.

Advanced settings for the block
The advanced section lets you add HTML anchor and a CSS class to your block.

“HTML anchor” allows you to make a unique web address for a particular “Group” block. Then, you’ll be able to link directly to a “Group” block of your page.

The “Additional CSS class(es)” lets you add CSS class(es) to your block, allowing you to write custom CSS and style the block as you see fit.


  • Updated 2022-11-25
    • Removed redundant content
    • Added alt text to the some images
  • Updated to include Dimension controls for WP 5.9 2022-01-17
  • Updated with new images for WP 5.6 2020-11-27
  • Created 2020-09-21

Was this article helpful? How could it be improved?

First published

Last updated