Blocks » Gallery Block
The Gallery block allows you to easily add multiple photos and have them automatically arranged in an attractive way.

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.

- 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
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.
Captions
Once you’ve uploaded your images or have chosen them from your Media Library, you can caption each image:

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.
Alignment
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.
Edit Gallery
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.

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.

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, click the ‘cog’ icon next to the Publish button.
Columns
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!
Cropping
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.
Linking
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.
None
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).
Advanced
The advanced tab lets you add a CSS class to the Gallery block, which can be used to style the gallery further. Learn more.