This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

WP Tiles


WP Tiles is a WordPress plugin that allows anyone to create beautiful tiled layouts for their website.

With WP Tiles you can:

  • Display your latest blog posts in a fully customizable and responsive grid layout
  • Show a tiled archive of any post type, category or other taxonomy
  • Create beautiful tiled image galleries using the WP Media Uploader

To experience for yourself how easy it is to create grids with WP Tiles, checkout the grid designer on our website.


  • Displaying Posts: The simplest way of using WP Tiles is by placing the [wp-tiles] shortcode somewhere on any of your pages or posts. Just add [wp-tiles] to your post to view the default tiles. However, WP Tiles is extremely flexible, allowing you to specify what content you want to display on your tiles, whether to display background images or skip posts that have no featured image, and much much more.

  • Create a tiled gallery: You can use WP Tiles to replace your default WordPress [gallery] shortcode. Simply create a gallery and select the grid you want to use, and you are good to go. Images can link to the attachment page, the image file, or be opened using a Thickbox, or with JetPack’s Carousel (or the Gallery Carousel without JetPack plugin!).

Update: We recently released our free Twenty Fourteen child theme for WP Tiles. Check it out here.

Other Features

Pagination using the shortcode
The shortcode can be automatically paginated. The plugin includes AJAX pagination (without page reload), previous/next page navigation and page number navigation.

SEO Friendly
The Tiles require JavaScript to be rendered, but they are readable by bots that don’t use JavaScript, and even include basic microtags and are generated using clean HTML5. This means that you can safely use WP Tiles as a primary element on your page without worrying about SEO.

Grid Builder and Tile Designer
The admin interface comes with a live editor for grid templates, so you can immediately see what grid templates look like. Tiles and bylines also come with a collection of hover effects and a list of adjustable properties that you can edit and preview immediately in the Tile Designer.

Completely custom bylines
The bylines are now generated using a custom template, the mark up and content of which you can control entirely. You could even start showing complete posts on tiles if you want to!

For complete documentation, check out the website at

If you want to help develop this plugin, visit the GitHub repo.



Install the plugin the usual way, and activate it.

You will now have a menu item for WP Tiles where you can edit your Grid templates and the plugin default options. In your post and page editor, you can generate the WP Tiles shortcode by clicking the button the toolbar.

For complete documentation, check out the website at


Installation Instructions

Install the plugin the usual way, and activate it.

You will now have a menu item for WP Tiles where you can edit your Grid templates and the plugin default options. In your post and page editor, you can generate the WP Tiles shortcode by clicking the button the toolbar.

For complete documentation, check out the website at

I get a notice saying that I need to upgrade my PHP version, what does that mean?

Check out this post on our website.

My images are blurry / pixelated / low quaility! What’s up?

WP Tiles by default uses the large image size provided by WordPress. This is the same size as you would get when you insert an image into a page and select ‘Large’ for its size. However, users (that’s you!) can change this size in their admin panel (in Settings -> Media). If the large size is smaller than the largest tile, the images will be stretched (proportionally).

There are 3 ways out:

  1. Change your Large image size to be bigger (in Settings -> Media)
  2. Select a different size for WP Tiles to use in the admin panel (WP Tiles -> Image Settings)
  3. Override the image size in the shortcode: [wp-tiles image_size='full']
WP Tiles is loading slow! What can I do?

See the previous question! WP Tiles uses the large image size in WordPress by default. If that size is gigantic, or if you have set WP Tiles to use an even larger size (like full), then WP Tiles will load heavy images. Adjusting the image size down should make your website load faster again.

WP Tiles is not selecting the image I want from posts! Hm?

By default, WP Tiles will try its hardest to select an image from your posts, in this order:
1. Featured Image
2. First attached image
3. First image in post itself

If you want to limit this, there are 3 options, either in the admin panel (WP Tiles -> Image Settings), or in the shortcode ([wp-tiles image_source=...]):

Attached Only attached_only – Don’t look inside post content for image
Featured Image Only featured_only – Only use Featured Image
Only show image for Media Posts attachment_only – Don’t show image, unless the post itself is a media post

Can I change what is shown on the tiles?

Yes! The content of the tiles is determined by the ‘byline template’. As with everything in WP Tiles, you can either set the template in the options panel, or put it in the shortcode directly. In the shortcode use the byline_template attribute for the byline on image tiles. Use byline_template_textonly for bylines on text-only tiles.

In the template, wherever you put the following tags, they will be replaced by content from the post:

  • %title%, %content%, %date%, %excerpt%, %link%, %author%, %featured_image% – All taken from the post
  • %categories% – Comma separated list of categories
  • %category_links% – Like above, but with links
  • %tags, %tag_links% – Same as categories
  • %meta:META_KEY% – Replace META_KEY by the meta key you want to display
  • %tax:TAXONOMY%, %tax_links:TAXONOMY%

Also see this page in our documentation.

Can I add WP Tiles to my theme or plugin? Or can I show tiles in my templates, for example on in the category archives?

To show WP Tiles in your templates, there are template tags available. See the documentation on the website here.

Can I hide the tooltips that appear when I hover over tiles?

It’s not a default WP Tiles option, but there is a simple plugin that does exactly that:

No Title Tooltips


November 23, 2020
Unfortunately his plugin doesn't works anymore correctly with latest version of WP. It's bases on very old code base (the now abandoned vafpress-framework) and there are no updates since 5 years. I've managed to FIX it, but I'm not sure it will be ever updated by author. This Plugin it's really simple, powerfull and FANTASTIC! It can replace TONS of very hard to use widget and amenities of most templates! I've just got Avada Theme, and I was really disappointed about not having a customizable tiles object. The Avada's Blog object is something 20% of this plugin, the other objects such as "Latest articles" or "Portfolio" box are even worser! And since it's opens source you are free to modify it and also if documentation of this plugin is a little bit poor for a WP novice like me, this address many limitations about missing examples (thee are 5 very nice examples web sites, but... why you don't show the short code you have used on each site?!)
December 27, 2018
I was impressed at option to create tiles with my own dimensions, just what I needed. It can be seen that many, many working hours were spent into this plugin. And it still works in Wordpress 5.02. I only found that option for different grid at mobile is not functioning, I will see if I can fix it. I also modified Javascript in a way that it loads 16:9 tiles instead of quadratic ones.
August 8, 2018
This plugin is a waste of time. It doesn't work like they tell you. For whatever reason, I can't create tiles and the button to add tiles on the Pages section of Wordpress doesn't work. BOO!!!
January 15, 2018
It's great plugin all in all! Not updated for 2 years. It's buggy! If you don't solve this, then you get 1 star. I will change it to 5 stars, if you solve the problems in this topic:
December 6, 2017
Great plugin, can see myself using it a lot. Only thing that's lacking is the documentation which isn't very complete.
Read all 69 reviews

Contributors & Developers

“WP Tiles” is open source software. The following people have contributed to this plugin.


Translate “WP Tiles” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Bug: Site administrators could create a stored XSS on the WP Tiles admin pages. Thanks to Th3R3p0 for finding and reporting this vulnerability!


  • Bug: Fix script error that caused background images to disappear from tiles (lots of thanks to Thomas Bouffon!)


  • Only display users that have published posts in the admin interface
  • Better admin performance on large sites (thanks @csdaavid!)


  • Released TiledFourteen, a free theme for WP Tiles
  • Added: Filter for the ‘Load More’ text (wp_tiles_load_more_text) when using AJAX pagination
  • Fix: WP Tiles was conflicting with Squirrly admin page. Removed fixed position on the the admin page
  • Fix: Path for the textdomain was not relative, causing errors
  • Fix: WordPress uses another paging parameter on the front page (page instead of paged). WP Tiles now detects this


  • Complete overhaul of the plugin 🙂 New features include:
  • Grid Builder and Tile Designer
  • (AJAX) Pagination using the shortcode
  • Tiled Galleries
  • New shortcode syntax and button in editor
  • Made the output SEO Friendly
  • Completely custom bylines
  • Modern Styles
  • Grids repeat infinitely (no fallback to 1×1 template)
  • Tile animation (on load, window resize or template selection) is now optional
  • Automatic elipsis for multi-line content
  • Hides current post when used inside the loop (can be disabled)


  • Last version that is compatible with PHP5.2.X. Added compatibility message for when the 1.0 update happens.


  • Last update before release of WP Tiles 1.0. This update contains information and notices about the forthcoming update.


  • Added wp-tiles-byline filter


  • Made plugin compatible with qTranslate


  • Added categories to tile classes


  • Make sure images are still grabbed correctly when showing post attachments


  • Fix warning static declaration of WP_Tiles_Settings_Config::dropdowns. (Thanks @chrishas35)
  • Allow for more complicated queries in the shortcode, using curly braces for arrays.


  • Load admin class at a later stage, so Custom Post Types have the time to register


  • Trigger window resize event for browser compatibility
  • Use minified scripts unless SCRIPT_DEBUG is true


  • Use cache when finding first image
  • Made first image pluggable
  • Allow multiple post types to be queried by using post_type{}=xxx&post_type{}=xxx in the shortcode


  • Made all template functions pluggable
  • Fixed dates showing date of parent post


  • Updated to new version of Tiles.js
  • Added customizable cellpadding option
  • Improved admin documentation


  • Fix loading of templates from settings instead of from defaults


  • Fix bug where numberposts argument doesn’t work from the settings and the shortcode


  • Restored the_wp_tiles() template tag behaviour to pre-0.4 for backwards compatibility
  • Added the_category_wp_tiles() and the_loop_wp_tiles() for more fine-grained control over WP Tiles in themes
  • Fixed: since 0.4 show_selector wasn’t properly saved in the settings page


  • Updated to new version of Tiles.js


  • Use existing query when used on category page (allows for pagination!)



  • Added options to show dates in byline
  • Some updates to the FAQ section


  • Fix: tiles weren’t outputted on the place of the shortcode


  • Added template function the_wp_tiles(), which renders the tiles (if on posts or archive page for current category)


  • Make sure that tile text background does show up when default is selected


  • Added option to use random colors for tile texts (colors and opacity configurable)


  • Added option for cut-off point small-screen / big-screen templates
  • Hide template selector if small screen template is used
  • Added all possible ‘order by’ parameters to the settings screen
  • Improved settings screen
  • Various small fixes (thanks raubvogel)


  • Added extra display options: show text and byline contents (choose whether to show categories, excerpts or nothing at all)


  • Centered cut off tile images
  • Tiles can now be inserted with a greater offset from the top


  • Fix resize bug – now rest of content is displaced properly
  • Background now always stretches to cover
  • Also checks for featured image (oops)
  • Fixed that templates would sometimes get lost when saving the first time
  • Extended wp-tiles-data filter
  • Added ‘wp-tiles-hide-byline’ filter, to hide the byline box on a per-post basis (only programmatically..)
  • Various other fixes
  • Fix loading of stylesheet from (child)theme
  • Fix small screen (mobile) template would add an extra row of single posts
  • Added wp-tiles-image-size filter to set the image size used for the tiles


  • Change the way templates are handled in the shortcode – now you can choose a predefined template by its name in the shortcode (eg. [wp-tiles template="Banner"]).


  • Fixed shortcode attribute handling


  • Fixed “T_PAAMAYIM_NEKUDOTAYIM” error with PHP < 5.3.


  • First upload.