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

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 Select Images.

Upload allows you to upload a new image or multiple images to from your compuer to your website.

Select Images lets you choose from previously uploaded images in your Media Library, or choose from Google Photos or the Pexels Free Photo library.

↑ Table of Contents ↑


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

Gallery block image with the caption box highlighted in an orange box.

If you have written captions for images in the Media library and then add the Gallery block, the Gallery block will show the captions you wrote. However, if you add captions to the images in the Media library after adding the Gallery block, those captions will not appear in the Gallery block. In that case, you can either type the captions manually on the Gallery block or remove and re-add the block so that it will use the captions from the Media library.

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

You can also enable/disable the image carousel and modify its settings (background color, show/hide photo metadata, and comments).

↑ 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