Images » Gallery
Embed, gallery, gallery shortcode, Images
Contents
Related
An image gallery will display a set of thumbnail images attached to a particular post or page. When clicked, gallery images are displayed in a full-size carousel view.
If you upload images using the Add Media button above the post/page editor, they will be attached automatically. If you want to include images that you’ve already uploaded, you’ll need to attach them to a post or page before they will appear in a gallery.
Image galleries look like this:
Adding a Gallery
- Open a post or page for editing. If it is a new post or page, make sure to add a title and save it at least once before trying to insert a gallery.
- Click the Add Media button.
- Drag and drop your files into the box that appears, or click Select Files to choose a picture from your computer to upload.
- Click Save all changes.
- Customize the gallery settings. (See below for details.)
- Click Insert gallery.
Editing a Gallery
- Open a post or page with a gallery for editing and make sure that you are in the Visual editing mode.
- Click on the gallery and then click the Edit Gallery icon that appears.
- To customize the order of the images, enter an order number next to each image, and be sure to select the Order Images By: Menu Order option in the gallery settings at the bottom.
- Click Show next to each image to change the title, caption, link URL, size and description for each image.
- Make sure to click the Save all changes button before you try to update any of the other gallery settings.
- Customize the gallery settings (see details below).
- Click Update gallery settings.
Gallery Settings
- Link thumbnails to:
- Image File: A direct link to the full size uploaded image.
- Attachment Page: A specialized page in your blog that shows the image in your selected theme.
- Order: Menu order, Title, Date/Time, or Random.
- Order images by: Ascending or Descending
- Gallery columns: The number of columns of thumbnails to display. This may be affected by your choice of theme, so be sure and test a bit with your current theme.
Gallery Shortcode
The gallery shortcode can be used in its simplest form like this (and will display the post or page’s gallery):
[gallery]
You can also pass other settings with the gallery shortcode.
| Option | Description | Choices | Default Setting |
|---|---|---|---|
| columns | Number of columns used to display the images | An integer greater than 0 | 3 |
| link | How each image will be linked | file | file |
| orderby | How to order the images | ID, menu_order, rand, title + ASC, DESC | menu_order ASC, ID ASC |
| size | Size of the images to display | thumbnail, medium, large, full | thumbnail |
| id | The gallery will display images which are attached to that post. | Any post or page ID that has images attached to it | Default is to show the gallery post |
| include | The gallery will include specific images | comma separated attachment IDs* (include=”23,39,45″) | N/A |
| exclude | The gallery will exclude specific images | comma separated attachment IDs* (exclude=”24,30,43″) | N/A |
* Note: To get an attachment ID for an image, go to your Media Library and hover over the image title you want to exclude. You can find the ID in the URL (the number after attachment_id=).
Examples:
[gallery id="402"]
[gallery columns="5" orderby="title DESC, ID ASC"]
Here is the gallery for this support page:
Troubleshooting
If you have trouble creating a gallery in your post, try entering the title and saving it as a draft before you upload any images.
Video
Last modified: November 17, 2011
Still confused?
Help us improve:
We're always looking to improve our documentation. If this page didn't answer your question or left you wanting more, let us know! We love hearing your feedback. For support, please use the forums or contact support form. Thanks!
