Blocks »Gallery Block

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

Add a gallery and arrange it into different column configurations.
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.
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.

Gallery Block - Add images

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.

One important thing you can do in the Edit Gallery screen that you can’t do in the block itself is rearrange your images. To do that click the Edit button, then drag and drop your images in the order you’d like them to appear in the gallery.

↑ Table of Contents ↑

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.

The block settings can be found in the sidebar.
The block settings can be found in the sidebar.

↑ 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, and None. 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.

Not quite what you're looking for?

Get Help