Most properties can be set in the style sheet or in the custom CSS module for your theme. The following settings are shortcode settings that apply to individual grids. Note that for width and height values you may use any valid unit of height: px, cm, %, etc. Note: Media Image sizes are configured in the wordpress admin panel under Settings/Media. The default thumbnail size is 150px by 150px. The style sheet is configured to handle the default thumbnail size. To properly display your images, you must modify the height and witdth in the thumbanil shortcode or the style sheet.

Many of the parameters available in the WordPress Codex can be used in the shortcode, with a few exceptions.

Default Settings as of version 6.0

All settings default to empty, null or false except for the following (be aware that this may have changed from previous versions)
‘post_type’ = ‘post’
‘showcaption’ = true
‘imagesize’ =’thumbnail’
‘posts_per_page’ = -1


The width of the grid. this value defaults to the width of the grid area or to the setting in the style sheet.

maxgridwidth – as of ver. 5.3

Use max width instead of width with align to wrap the grid when the window resizes.

When the gridwidth value is set, set this value to left, right, center or autocenter (as of version 5.3). center may not work in all themes. autocenter uses jQuery to center the grid instead.

thumbnailgrid maxgridwidth=”700px” post_type=”post” aligngrid=”left” posts_per_page = “3” cat=”41″

thumbnailgrid maxgridwidth=”700px” aligngrid=”right” post_type=”post” posts_per_page = “3” cat=”41″

thumbnailgrid maxgridwidth=”700px” aligngrid=”center” post_type=”post” posts_per_page = “3” cat=”41″

thumbnailgrid aligngrid=””autocenter” cat=”41″ post_type=”post”


Set showcaption=FALSE to hide the captions showcaption defaults to TRUE

thumbnailgrid showcaption=FALSE posts_per_page = “3” post_type=”post” cat=”41″

This value sets the caption height and hides the overflow (if there is more text than can fit into the caption area, it will not be visible). The display defaults to one line of text or the value in the style sheet.

The caption width. This value defaults to the width variable above or to the setting in the style sheet.

Wrap the text in the caption. Normally the text is limited to one line and overflow is indicated by an elipses. Please note that, to avoid a misaligned grid, you should set a caption height when wrapping text in a grid that has more than one row. wraptext defaults to FALSE

thumbnailgrid wraptext=TRUE captionheight=”50px” posts_per_page = “3” post_type=”post” cat=”41″


has_thumbnails (as of version 6.0)

When set to true, only thumbnails with images will be displayed in the grid

The height of thumbnail image. This value defaults to the height of the thumbnail or the setting in the style sheet.


The width of the thumbnail image. This value defaults to the width of the thumbnail or the setting in the style sheet. To display an image proportionately, set this value to ‘auto’;

thumbnailgrid width=”25px” height=”25px” posts_per_page=”3″ post_type=”post” cat=”41″

If you have images of different sizes, use a fixed height and set the width to auto to display your thumbnails proportionately.

thumbnailgrid cat=”41″ posts_per_page=”3″ imagesize=”medium” height=”100px” post_type=”post” width=”auto”


Media Image sizes are configured in the wordpress admin panel under Settings/Media. You can use any size in the plugin. The default value is ‘thumb’. thumb thumbnail medium large post-thumbnail.

If you wish, you can display the posts at the appropriate size for the image.

thumbnailgrid cat=”41″ posts_per_page=”3″ post_type=”post” imagesize=”medium” height=”200px” width=”200px”


Reminder: A page is a type of post. Use post_type to display thumbnails for pages or for custom posts.

thumbnailgrid post_type=”page”

You can use the following parameters to restrict posts. All of these parameters take a comma delimited list of post (or page) id’s except for the tag_slug parameters.


thumbnailgrid post_type=”post” author__in=”20″

author__not_in (Not currently working)


thumbnailgrid post_type=”post” category__and=”41, 142″


thumbnailgrid post_type=”post” category__in=”41, 143″

category__not_in (Available in version 5.4 and up)

thumbnailgrid post_type=”post” has_thumbnails=’TRUE’ category__not_in=”142, 143,144″


thumbnailgrid post_type=”post” tag__and=”62, 45



thumbnailgrid post_type=”post” tag__in=”62, 45, 46″

tag__not_in (Available in version 5.4 & up)

thumbnailgrid post_type=”post” has_thumbnails=’TRUE’  tag__not_in=”62, 45, 46, 145, 147″

tag_slug__and (available in version 5 & up)

thumbnailgrid post_type=”post” tag_slug__and=”hac, gravida”

tag_slug__in (available in version 5 & up)

thumbnailgrid post_type=”post” tag_slug__in=”hac, gravida, semper”

post_parent__in (available in version 5 & up)

thumbnailgrid post_type=”page” post_parent__in=”208″

post_parent__not_in (available in version 5 & up)

thumbnailgrid post_type=”page” cat=”41″ post_parent__not_in=”208″ has_thumbnails=’TRUE’

post__in (available in version 5 & up)

thumbnailgrid post_type=”post” post__in=”169,146″

post__not_in (available in version 5.4 & up)

thumbnailgrid post_type=”post” post__not_in=”144, 169,146,790″ has_thumbnails=’TRUE’


day, month, year

thumbnailgrid month=”11″ year=”2014″ day=”30″ has_thumbnails=’TRUE’

before, after, inclusive (available in version 5 & up) -
Set a date range using before & after. Set inclusive = true to include before & after in the query.

thumbnailgrid before=”December 30, 2014″ inclusive=true has_thumbnails=true

thumbnailgrid after=”November 29, 2014″ has_thumbnails=true

thumbnailgrid before=”December 1, 2015″ after=”January 1, 2014″ has_thumbnails=true

You may also use “today” in place of the date. (Version 5.0 & up)

thumbnailgrid before=”today” inclusive=true has_thumbnails=true


Setting debug_query to true can be used by advanced users to diagnose the query generated by this shortcode or for support purposes.

thumbnailgrid debug_query=true has_thumbnails=true


  • Darja Vasiljeva

    How to display custom taxonomy posts? I use [thumbnailgrid post_type=”mycustomposttype”] and its shows me all of the custom type posts. But what i need to include, to show just some of them, in particular custom taxonomy?

    • Web Master

      Check your email!

  • Pingback: Featured Image Thumbnail Grid | Shoofly Solutions()

  • Patti Estep

    Hi, Works great on desktop. Only shows one thumbnail per row on mobile (iphone 6) Is there any coding or css styling to make it show more thumbnails on mobile? Thanks