Blocks »Gallery Block

The Gallery block allows you to easily add multiple photos and have them automatically arranged in an attractive way.

Table of Contents

These steps are for our new block editor. If you’re using the Classic editor, see these steps here.

Add a gallery and arrange it into different column configurations.

To add a Gallery block, use the Add Block button, or you can type /gallery and press enter.

Detailed instructions on adding blocks can be found here.

Block Toolbar

Each block has its own block-specific controls that allow you to manipulate the block right in the editor. 

The gallery toolbar supports multiple alignments including wide and full width depending on the theme.
  • Change block type
  • Align Left
  • Center
  • Align Right
  • Wide width (when supported by the theme)
  • Full width (when supported by the theme)
  • Edit
  • More Options

↑ Table of Contents ↑

Adding Images

When you add a Gallery block, you’re given two options, Upload and Media Library.

Upload allows you to upload a new image or multiple images to the Gallery block and your media library, while Media Library lets you select from previously uploaded images in your Media Library.

Once you’ve uploaded your images or have chosen them from your Media Library, you can caption each image.

↑ Table of Contents ↑


There is a toolbar that appears when you select the block, and which will let you select alignment options for the block. You can align left, center, or right. When using the left and right alignment options, you can add another block alongside the Gallery block.

↑ Table of Contents ↑

Use the Edit Gallery button, which looks like a pencil, if you want to add or remove images, or edit a caption in your gallery. It is also possible to do these things in the block itself.

Reordering Images

The images are added to the Gallery in the order that you select them when in Edit Gallery. You’ll notice a number next to each image when you select it. This number indicates what order the image will appear in your Gallery block.

Reorder Images in the Gallery block using Edit Gallery

You can also reorder the gallery images after you have created the gallery. To do this, click on any gallery image and use the left/right arrows to reorder the images.

Reorder Images in the Gallery block using the left/right arrows

↑ Table of Contents ↑

Block Settings

Every block has specific options in the editor sidebar in addition to the options found in the block toolbar.

WordPress Editor - Settings

If you do not see the sidebar, click the ‘cog’ icon next to the Publish button.

↑ Table of Contents ↑


You can choose how many columns your Gallery block will have. You can select between 1 column and 8 columns.

You can only select as many columns as you have images, so if you add 4 images, you’ll be given the option for a maximum of 4 columns. This number will increase as you add more images until you reach the maximum of 8.

Your images will automatically arrange themselves to look good no matter how many columns you select. Try changing the setting and see what you like best!

↑ Table of Contents ↑


You can select whether or not you’d like your images to be cropped in your Gallery block. This option is useful if you have images of varying sizes and shapes. Cropping them will make the images in each row of the gallery the same size. Try it each way and see which looks better to you.

↑ Table of Contents ↑


You have 3 options for linking the images in your gallery:

  • Attachment Page
  • Media File
  • None (default)

This determines what happens when your visitors click on the images in your gallery.

Attachment Page

This will lead anyone who clicks on your image to your site’s attachment page. This is an informational page about your image, which includes the image, the caption, the image description, and a comment field.

Media File

This loads the images in a full-screen carousel, which your visitors can go through one image at a time.


This makes your images unclickable, so they don’t link to anything at all.

↑ Table of Contents ↑


The advanced tab lets you add a CSS class to the Gallery block, which can be used to style the gallery further. Learn more.

Pages: 1 2 View All

Not quite what you're looking for?

Get Help