Blocks, Media Blocks

Blocks » Gallery Block

Use the Gallery block to display multiple photos together. The Gallery block contains individual Image blocks for each image and arranges them in an attractive way.

Table of Contents

Video Tutorial

↑ Table of Contents ↑

To add the Gallery block, click on the + Block Inserter icon and search for “gallery”. Click it to add the block to the post or page.


Using your keyboard, you can also type /gallery on a new line and press enter to quickly add a new Gallery block.

GIF showing the process of typing /gallery to insert a Gallery block.

For more, visit our detailed instructions on adding blocks.

↑ Table of Contents ↑

Add Your Images

When you add a Gallery block, you’re given two options: Upload and Select Images:

The Gallery block shows two options: Upload and Select Images.

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

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

↑ Table of Contents ↑

You can add more images to a gallery you have already created by doing the following:

Step 1: Select the Gallery block. There are a couple of ways to select the Gallery block.

Either, click on an image in the Gallery block and then click the Select Gallery icon in the toolbar above the image.

Or, click List View at the top left of your editor, and select the Gallery block from the outline.

Step 2: Click Add in the toolbar above the Gallery block to add more images.

Once you click Add you can select Open Media Library to add images you have already uploaded (or access the free media options) or Upload to upload new images to your gallery.

↑ Table of Contents ↑

Block Toolbar

When you click on the block, a toolbar of options will appear:

A gallery is selected and the alignment options expanded.
The gallery toolbar supports multiple alignments including wide and full width depending on the theme.

The Gallery block has the following options in its toolbar:

  • Change the gallery to another block such as Image, Slideshow, or another gallery format.
  • Align left, right, or center (and wide and full widths if supported by the theme.)
  • Add to add more images
  • More options


If you do not see the option to change the width of the block to wide or full-width and your theme supports these options, it is possible the block has been added to a Group block. You can learn more about the Group block here.

↑ Table of Contents ↑

Block Settings

When you click on the block, you will find additional block settings in the right sidebar. If you do not see the sidebar, you may need to click on the ⚙️ (gear/ cog) icon in the top right corner to bring up the settings.

The block settings can be found in the right sidebar.
Block settings
  1. Click on the white space between the images.
  2. Select the Gallery block using List View.
  3. Select Gallery from the breadcrumbs at the bottom of the screen:
The breadcrumbs at the bottom of the editor screen are shown, with gallery marked by an arrow.

The Gallery block has the following settings:


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 into the best configuration according to the number of columns you select. Try changing the number of columns to see what you like best.

Crop Images

You can select whether or not you’d like your gallery images to be cropped. This option is useful if you have images of varying sizes and shapes.

If the images in your gallery are different sizes, cropping the images will give the images a more uniform appearance as shown below. If you do not wish to crop the images but still want the images to appear the same size, make sure to upload image files that already have the same size.

A gallery with cropped images:

An example of a gallery with cropped images, showing all images with a uniform size.

A gallery without cropped images:

An example of a gallery with uncropped images, showing uneven image sizes.

In the Gallery block settings, there are three options for linking the 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. View Media Settings to adjust the carousel settings.
  • None (default): This makes your images unclickable, so they don’t link to anything at all.

Alternatively, you may wish to link individual images in the gallery to different pages. You can link an image by following these steps:

  1. Click on the image you wish to link.
  2. In the toolbar that appears, click the link icon (it looks like a link from a chain):image toolbar with the link icon highlighted
  3. Click the pencil icon to edit the link.
  4. Paste the URL you wish to link the image to, or use the search box to select a published page on your site.
  5. Press Enter on your keyboard to confirm the change.

For more on linking individual images, see our Image block guide.

↑ Table of Contents ↑

The images are added to the Gallery in the order that you selected them originally. 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.

GIF showing how to Reorder Images in the 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:

GIF showing how to Reorder Images in the Gallery block using the left/right arrows

Alternatively, you can click on an image and choose the drag option (the icon looks like six dots) from the toolbar to move your image:

The drag option in the image toolbar is marked with an arrow.
Use the Drag option in the toolbar to move images.

To copy images, duplicate them or remove an image, click on the three dots on the upper right of the toolbar and select the option you desire.

Image shows an image block selected, the ... clicked to expand more settings, and the copy option highlighted.
Copy, duplicate, or delete images using the expanded toolbar settings.

↑ Table of Contents ↑

Add Image Captions

After adding images to your gallery, you can caption each image by clicking on that image, then clicking the Add caption area:

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.


The advanced tab lets you add a CSS class to your block, allowing you to write custom CSS to style the block. Learn more about adding additional CSS classes to blocks.

Recipe block - Advanced Settings
The advanced section lets you add a CSS class to your block.

Not quite what you're looking for?

Get Help