Support Home > Utilities > Tiled Gallery Block

Tiled Gallery Block

With Tiled Galleries, you can display your image galleries as a tiled mosaic, circular grid, square tiles, or tiled columns. There is also a slideshow option.

Important: Images added to a Tiled Gallery block are automatically served through Jetpack’s Image CDN, even if you have Jetpack’s Site Accelerator feature disabled.

Here are some examples:

Tiled Galleries in the Classic Editor

To use Tiled Galleries using the Classic Editor plugin or the Classic Block, please see this guide.

To create a gallery, add a new Tiled Gallery block either with the in-post block selector or using the block selector in the post toolbar.

Tiled Galleries block option in the block picker

After adding the block, you can add images to your gallery in the same way that you can add images to a regular image block.

You can upload them from your computer, select them from your Media Library, or select them from an external source.

Once you’ve added images, you can use the block toolbar and the sidebar to add your customizations.

With the toolbar, you can use the change block type button to select the type of gallery you’d like to create.

You can also change the block to one of the other image block types here.

The other buttons on the toolbar allow you to set the alignment for the gallery by selecting the appropriate option. You can use Edit to add and remove images.

This image has an empty alt attribute; its file name is screen-shot-on-2019-01-07-at-15-40-09.png

You can deselect any you don’t want to include in the gallery by clicking on the X. Drag and drop the images to reorder.

Click Add to Gallery to add new images. When you’ve finished making changes to the images in the gallery, click Update gallery.

To position images within your gallery, you can click on an image within the block and use the arrow buttons to move them:

This image has an empty alt attribute; its file name is tiled_gallery_move_image.png

Block Sidebar

In the Block sidebar, you can expand the Styles section to change the gallery type and assign link behavior in the Tiled gallery settings section:

This image has an empty alt attribute; its file name is tiled-gallery-block-settings.png


Tiled Gallery options do not appear, or do not display correctly

  • Go to Jetpack → Settings → Performance and make sure the Site Accelerator option is enabled.
  • Try switching to a different theme to check if your theme is conflicting with Jetpack’s Tiled Galleries.
  • Disable any other slideshow or gallery plugins to rule out a conflict.
  • Finally, if you use the Cleaner Gallery plugin or a theme including this functionality, you won’t be able to use the Tiled Gallery features on your site. To solve this conflict, you can install this small plugin to deactivate Cleaner Gallery.

How to display a single image in a gallery view

To make a single image on a post or page appear in a gallery view, edit the image and set the Link To display setting to “attachment page”. Now, when your image is clicked, it will appear in the gallery overlay view.

Missing Slideshow option

If the Slideshow option is missing, go to Jetpack → Settings → Writing and make sure the Compose using shortcodes to embed media from popular sites option is enabled.

Define a specific width for your gallery

Tiled Galleries are built to fill your theme’s content width. You can define a specific $content_width value by adding the following code to your theme’s functions.php file:

if ( ! isset( $content_width ) ) {    
$content_width = 800;    

If you do not feel comfortable editing theme files, you can also use this plugin: Custom Content Width.

If your theme doesn’t define a content width, Tiled Galleries will default to 500px wide. You can read more about the Content Width theme feature here.

If your theme already defines a $content_width value, but you would like to use a different value for Tiled Galleries only, you can use the tiled_gallery_content_width filter.

Captions do not appear

The Tiled Gallery block doesn’t support captions (either per image or for the whole block) yet. Another alternative is to use the Classic block to add a Tiled Gallery which will allow you to add captions. There is more on how to do that here.

Still need help?

Please contact support directly. We’re happy to advise.

Privacy Information

The Tiled Gallery block is disabled by default. You can activate Tiled Galleries anytime by following these instructions and clicking “Activate” next to Tiled Galleries.

Data Used
Site Owners / Users


Site Visitors


Activity Tracked
Site Owners / Users

If disconnecting from Google Photos, we track that Google Photos is being disconnected.

Site Visitors


Data Synced (Read More)
Site Owners / Users

We sync options that identify whether or not the feature is activated and how its available settings are configured.

Site Visitors


  • Table Of Contents

  • Categories

  • Contact Us

    Need more help? Feel free to contact us.