The gallery block is very similar to how image galleries worked in the classic WordPress editor.
- Add multiple images to a gallery
- (Optional) Give the images a caption
- Choose the number of columns
- Insert your gallery onto the page
There are a few additional options in the new Gutenberg gallery block. Let's go over them now.
Choosing Your Images
Just like in the classic editor, you can choose your gallery images in two ways:
- select existing images in your Media Library
- upload new images from your computer
Once you've selected all your images, you'll click the Create new gallery button to insert the gallery onto the page. That's where the rest of Gutenberg's options come into play.
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.
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.
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:
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.