Images » Gallery
gallery, gallery shortcode, Images
A gallery will display a set of thumbnail images attached to a particular post or page. If you upload images using the Add an Image button while editing/creating the post or page, they will be attached automatically. If you upload images directly to the media library from Media -> Add New, you will need to attach them to a post or page before they will appear in a gallery.
Here is an example of an image gallery:
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 an Image button.
- Select files to upload and then click the Save all changes button. You should be taken to the Gallery tab next.
- Customize the settings. (Note that you can go back and change these settings later.)
- 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.
- Enter an order number next to each image. Make sure to select the Menu order option in the settings if you want to customize image ordering.
- Click Show next to each image to change the title, caption, 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.
Titles, captions, and descriptions for images are managed through the Show/Hide link next to each image or through the Media Library.
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 |
Examples:
[gallery id="402"]
[gallery columns="5" orderby="title DESC, ID ASC"]
Here is the gallery for this support page:
Video
Last modified: December 29, 2009
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!
