Use the Post Carousel block to display a slider of posts, pages, projects, or testimonials anywhere on your site. This guide will show you how to use it.
In this guide
To add a Post Carousel block, click on the + block inserter icon and search for the Post Carousel block. Click to add the block to a page, post, or template.
If you have a plugin-enabled site, make sure the WordPress.com Editing Toolkit plugin is active on your site at Plugins → Installed Plugins. If your site does not support plugins, the Post Carousel block is already available to you.
For more information, visit our detailed instructions on adding blocks.
After inserting the block, you will have a slideshow of your most recent blog posts. For a post to be displayed, it must meet the following requirements:
- The post must be published. Draft posts will not appear by default.
- The post must have a featured image.
- The post must not already be displayed elsewhere on the same page, such as in another Post Carousel block or a Blog Posts block. A post will only appear once on a single page.
In the Post Carousel block settings, you can customize which posts appear and how they appear, and you can choose different types of content other than posts. See the next section of this guide to learn how to customize the block settings.
When you select a block, you will find additional block settings in the right sidebar. If you do not see the sidebar, you may need to click the Settings icon in the top-right corner to bring up the settings. This icon looks like a square with two uneven columns:
The Post Carousel block has the following settings:
Here, you can choose which posts will be included in the slider:
- Choose Specific Posts: Select the exact posts to display in the slider.
- Number of items: Control how many posts will be displayed up to a max of 100 (keep in mind that 100 posts at once may considerably slow down your page loading time).
- Authors: Select specific authors’ posts to be displayed.
- Categories: Show posts with a specific category only.
- Tags: Show posts with a specific tag only.
- Slide Aspect Ratio: Choose the relationship between the width and height of the images in the slider.
- Image Fit: Determines if the image will crop to fit, or stretch to fit, the available area.
- Hide Controls: Remove the play and pause options from the slideshow.
- Autoplay: Control whether the carousel automatically switches slides (disabled by default).
- Number of slides to show at once: Choose how many images appear in a single slide (up to a max of 4).
Here, you can choose which information appears with your content in the slider:
- Show Title: Display the post title.
- Show Date: Controls whether the date will be displayed.
- Show Category: Controls whether the category will be displayed.
- Show Author: Controls whether the author’s name will be displayed.
- Show Author Avatar: Controls whether the author’s profile photo will be displayed.
Choose from different content types to display in the slideshow:
- Posts (default)
- Pages
- Portfolio projects
- Testimonials
You can optionally enable drafts and scheduled content to appear in the slider. As these types of posts are not visible to the public, they will only appear when the carousel is viewed by users with editing permission on your site. This is useful for editors and admins to see how a piece of content will appear in the carousel before it is published.
For more, visit our detailed instructions on Advanced settings.
When you click on the block, a toolbar of options will appear above or below it:
The Post Carousel block contains the following toolbar options from left to right:
- Change block type.
- Drag the block.
- Move the block up or down.
- Change alignment.
- More options.
