Adding a WordPress Gallery

Here is an example of a WordPress gallery.  Images are tiled neatly with captions.

1. Place your cursor

In order to add a WordPress image gallery, you must first insert you cursor in place in the WordPress page or post editor where you want it to appear. If you also have text on your page it will appear above or below your gallery, depending on where you place your cursor when creating it.

2. Click the Add Media button

Once you’ve placed your cursor where you want your image gallery to appear, click on the Add Media button to launch the WordPress media uploader interface, and select the Create a Gallery option from the list of actions in the left side of the window.

Add media

Doing the same with Gutenberg

Please note that the above relates to the classic editor.  If you wish to insert a gallery with the new Gutenberg editor you simply add a gallery block.  The only real difference here is that you don’t click the Add Media button above the post, you just insert the gallery block and then upload or select your images from the media library.

The Gutenberg Gallery Block

3. Add and/or Select the Images You Want to Include

You can add or select the images you want to include in your WordPress image gallery by choosing from either of the following options in the center of the media uploader window:

  • Upload Images: Upload the images you want to use from your computer by dragging them into the upload area. You can add more than one image, and they will be automatically grouped together as an image gallery.
  • Media Library: Select from previously uploaded images in the WordPress media library by clicking on the ones you wish to add to the gallery. You will see a checkbox next to your selections.

WordPress Upload screen

Note: You can create a WordPress image gallery using any combination of new images and previously uploaded images simply by switching back and forth between the Upload Files and Media Library tabs.

As you upload and/or select images, you will see your selection confirmed on the Insert Media screen by check boxes at the top corner of each thumbnail. Also, a row of thumbnails appears at the bottom of the window to help you keep track of all the images you’ve selected.

Screen Shot 2013-05-06 at 08.44.59

4. Create a New Gallery

Then you will need to make sure that create gallery is selected from the left hand menu as above.

When you are happy with your selection of images, click the blue Create a new gallery button at the bottom right hand side of your WordPress media screen. As shown above.

5. Edit Your Gallery

Clicking the blue create a new gallery button will bring you to the Edit Gallery page below.

On the Edit Gallery page, you can do the following things before inserting the gallery you have created into your page or post:

  • Rearrange your images: Drag and Drop image thumbnails to rearrange the order of images in your gallery.
  • Reverse Order: Reverses the order of the images in your gallery.
  • Add image descriptions: Add descriptions to your images (optional) which appear as image captions below each thumbnail in the gallery.
  • Remove images: Hover over a thumbnail and click on the “X” to remove any of the images you previously selected.
  • Add more images: Click on the “Upload Images” or “Image Gallery” links in the left hand sidebar to add more images to your gallery.
  • Cancel Gallery: Click on the “Cancel Gallery” link from the actions on the left to exit the Edit Gallery page and cancel your image gallery.

Organising your WordPress Gallery

6. Inserting your gallery

Before inserting your gallery, you also have several Gallery Settings available in a pane on the right to control the following:

  • Links To: Controls whether the gallery thumbnails (on the published page/post) link to the image attachment page, directly to the source image file itself or no link (which is probably the best idea).
  • Columns: Set the number of columns you would like to have in your gallery. 3 Columns is the default setting, which is ideal for most sites.
  • Random Order: Enables your gallery to display your image thumbnails in a random order each time they are viewed on the site.

Finally click on insert gallery.  The gallery will show in your WordPress post editor, as illustrated in the next section.

Settings with Gutenberg

The settings are pretty much the same with Gutenberg you just use the block settings instead.  Select the number of rows, whether you want to crop the images to fit and you can link the images if you wish but that shouldn’t really be done in a gallery.

Gallery block settings

Editing Existing Galleries

Within the visual editor, WordPress galleries can be edited by hovering over the gallery and clicking on the pencil icon that appears at the top of the gallery.  You can remove the gallery by clicking the x to the right of the edit pencil.

WordPress Gallery Edit


Much of the text content of this post was taken directly from the WordPress Codex.

© Copyright protected by Copyscape.