Gallery Shortcode « WordPress Codex http://codex.wordpress.

org/Gallery_Shortcode

Search the Codex Go

Home Showcase Extend About Blog Forums Hosting

Codex Codex tools: Log in

Gallery Shortcode Home Page

WordPress Lessons

Languages: English • • Português do Brasil • (Add your language) Getting Started

Working with
WordPress
In WordPress 2.5, the Gallery feature allows the option to add an image gallery to a Post or Page on your WordPress blog.
Design and Layout

Advanced Topics
The [gallery] shortcode is used in a Post or Page to display a thumbnail gallery of images attached to that post. It can be
Troubleshooting
used in its simplest form like this:
Developer Docs

About WordPress
[gallery]

Codex Resources
There are several options that may be specified using this syntax:
Community portal

Current events
[gallery option1="value1" option2="value2"]
Recent changes

Random page
You can also print a gallery directly in a template like so: Help

<?php echo do_shortcode('[gallery option1="value1"]'); ?>

This works too:

<?php
$gallery_shortcode = '[gallery id="' . intval( $post->post_parent ) . '"]';
print apply_filters( 'the_content', $gallery_shortcode );
?>

Options
The following basic options are supported:

columns
specify the number of columns. The gallery will include a break tag at the end of each row, and calculate the column width as
appropriate. The default value is 3. If columns is set to 0, no row breaks will be included. For example, to display a 4 column
gallery:

[gallery columns="4"]

id
specify the post ID. The gallery will display images which are attached to that post. The default behaviour if no ID is specified
is to display images attached to the current post. For example, to display images attached to post 123:

[gallery id="123"]

size
specify the image size to use for the thumbnail display. Valid values include "thumbnail", "medium", "large" and "full". The
default is "thumbnail". The size of the images for "thumbnail", "medium" and "large" can be configured in WordPress admin
panel under Settings > Media. For example, to display a gallery of medium sized images:

[gallery size="medium"]

1 of 2 06/03/2011 0:52
Gallery Shortcode « WordPress Codex http://codex.wordpress.org/Gallery_Shortcode

Some advanced options are available:

orderby
specify the sort order used to display thumbnails. The default is "menu_order ASC, ID ASC". "RAND" (random) is also
supported.

itemtag
the name of the XHTML tag used to enclose each item in the gallery. The default is "dl".

icontag
the name of the XHTML tag used to enclose each thumbnail icon in the gallery. The default is "dt".

captiontag
the name of the XHTML tag used to enclose each caption. The default is "dd". For example, to change the gallery markup to
use div, span and p tags:

link
you can set it to "file" so each image will link to the image file. The default value links to the attachment's permalink.

include
comma separated attachment IDs, [gallery include="23,39,45"] will show only the images from these attachments.

exclude
comma separated attachment IDs, [gallery exclude="21,32,43"] excludes the images from these attachments. Please note
that include and exclude cannot be used together.

[gallery itemtag="div" icontag="span" captiontag="p" link="file"]

Categories: Advanced Topics | WordPress Development | Shortcodes

Privacy | License / GPL See also: WordPress.com | WordPress.TV | WordCamp | WP Jobs | Matt | Fan WP on Facebook | Blog RSS

2 of 2 06/03/2011 0:52