Gallery Block

Share a group of images on your site in a gallery-style format.


The gallery block is very similar to how image galleries worked in the classic WordPress editor.

  1. Add multiple images to a gallery
  2. (Optional) Give the images a caption
  3. Choose the number of columns
  4. Insert your gallery onto the page

Image Captions

Captions are completely optional, but each image can have its own caption. The caption will typically appear at the bottom of each image, in white text with a semi-transparent black background.

However, each theme can choose to style image captions differently.

Gallery Columns

Gutenberg image galleries can be displayed in almost an infinite amount of columns, however, I recommend no more than about 6. After that, your images will appear very small.

Use the columns slider in the right sidebar to adjust your columns.

If you’re using images with different aspect ratios (i.e. landscape & portrait), you’ll likely want to keep the Crop Images setting on.

Crop images will ensure that your photos fit nicely within the number of columns you have selected. I’ll show you what I mean below.

Crop Images

In most cases, you’ll want to leave this setting on. A few reasons why you might want to turn it off include:

  • 1 column galleries
  • if you want to show each image exactly as it was taken

Crop images will automatically make adjustments to your images to ensure they fit perfectly into the number of columns you have selected.

You might lose part of your image, but your gallery will be displayed more beautifully. It’s a bit of a tradeoff.

Here’s an example:

Link Images

The final setting for the Gutenberg gallery block is the Link to setting. You have three options here:

  • None: Just display the image; no link
  • Attachment page: Links to a specific page on your site, dedicated to displaying information about the image. This is rarely used.
  • Media file: Opens the image file all by itself

Convert Gallery to Single Images

The only block you can convert a gallery to is the image block. Doing so will take each image in your gallery and turn it into its own image block.

Learn About Other Gutenberg Blocks

Scroll to Top