Description

A responsive carousel slider for the Gutenberg editor that supports adding any blocks to slides.

🚀 Carousel Slider Version 2 is here! Now powered by Swiper.js for a smoother, faster, and more modern experience. See below for update instructions.

Features

Add unlimited slides
Add any blocks to the slides
Preview the carousel in the editor
Responsive and touch enabled

Settings

Slides per view
Slides to scroll at a time
Slide speed
Slide padding
Prev/next arrows
Dots navigation
Infinite loop sliding
Autoplay
Responsive settings: slides to show and scroll at given screen size
RTL

Requirements

PHP 5.6+ is recommended, WordPress 5.8+, with Gutenberg active.

Documentation

Select the Carousel Slider block from the Design category. Click the + button located at the end of the carousel to add slides. Add any block within the slides. Use the horizontal scrollbar to preview the slides in the editor.

You can reorder the slides by using the left and right arrow buttons in the toolbar.

To remove a slide, select the slide and click the three dots right above it. Click the option to remove that slide.

Click the Carousel Block (the block nesting all the slides) to show the carousel settings.

Carousel Slider Version 2

Carousel Slider v2 now uses Swiper.js instead of Slick. It’s more modern, better supported, and works smoother across devices.

Upgrading from Legacy Carousel

Existing legacy (v1) Carousel Slider blocks will still work. You can disable them in the admin settings under Settings Carousel Slider.
To upgrade, click on a legacy Carousel Slider block in the editor. Then, in the block’s toolbar (the floating bar that appears above the block), click the block icon (first button on the left). From the dropdown, choose “Transform to Carousel Slider v2”. Your existing carousel settings will be preserved, but note that the design and HTML markup will change.
Legacy styles will not apply to v2. You may need to adjust custom styles.

Optional: Re-enable Legacy Blocks

You can show/hide legacy blocks from the block inserter and disable v2 upgrade notices via Settings Carousel Slider in the admin menu.

Note: Legacy blocks will continue to function, but are no longer supported. It is highly recommended to upgrade to v2 for continued improvements and compatibility.

Customizing v2 Styles

Carousel Slider v2 supports custom styling via CSS variables:

Navigation

--wp--custom--carousel-block--navigation-size: Arrow size
--wp--custom--carousel-block--navigation-sides-offset: Distance from edge
--wp--custom--carousel-block--navigation-color: Arrow color
--wp--custom--carousel-block--navigation-fullwidth-color: Arrow color when the carousel is full width

Pagination (dots)

--wp--custom--carousel-block--pagination-top: Top offset for pagination
--wp--custom--carousel-block--pagination-bullet-size: Dot size
--wp--custom--carousel-block--pagination-bullet-color: Dot color (inactive)
--wp--custom--carousel-block--pagination-bullet-active-color: Dot color (active)
--wp--custom--carousel-block--pagination-bullet-opacity: Dot opacity (inactive)
--wp--custom--carousel-block--pagination-bullet-active-opacity: Dot opacity (active)
--wp--custom--carousel-block--pagination-bullet-horizontal-gap: Horizontal spacing between dots
--wp--custom--carousel-block--pagination-bullet-vertical-gap: Vertical spacing between dots

Block spacing

--wp--custom--carousel-block--image-margin-top: Top spacing for image blocks
--wp--custom--carousel-block--image-margin-bottom: Bottom spacing for image blocks
--wp--custom--carousel-block--cover-margin-top: Top spacing for cover blocks
--wp--custom--carousel-block--cover-margin-bottom: Bottom spacing for cover blocks

Note: The CSS variables use the WordPress --wp--custom-- prefix, allowing you to override them in your theme’s theme.json for site-wide styling.

Screenshots

Carousel slider
Add any blocks to the carousel slides
Carousel settings

Blocks

This plugin provides 4 blocks.

Carousel Slider Display a carousel with any blocks in the slides.
Carousel Slider v2 Display a carousel with any blocks in the slides.
Slide A single slide within the carousel.
Slide A single slide within the carousel.

Installation

From your WordPress dashboard go to Plugins > Add New.
Search for Carousel Slider Block in the Search Plugins box.
Click Install Now to install the Carousel Slider Block Plugin.
Click Activate to activate the plugin.
Carousel Slider Block will be added to the Design block group in the editor.

If you still need help. visit WordPress codex

FAQ

What is Gutenberg?: Gutenberg is the name of the new block based editor introduced in WordPress 5. Gutenberg makes it easy to create content within the editor using blocks.
How do I add a carousel to WordPress?: Select the Carousel Slider block from the Design category.
How do I add a slide to WordPress?: Select the Carousel Slider block. Click the plus button to add slides to the carousel.

Reviews

BobRebus Mas 24, 2025

Does what it says. Simple and practical, easy to use. Thank you for creating this!

samuele99 Mas 14, 2025

Incredible flexibility, it integrates perfectly into the current Gutenberg blocks pool for its functionality and layout. I noticed that the support is somewhat missing, probably because the developer is alone in this. It would be great if the community could help maintaining this so useful piece of code for as long as possible.

freelancesgroup fevriye 10, 2025

Very easy to use and works very well

petertau Desanm 12, 2024

Works like a charm, simple or complex it is up to you.

skiwhitefish Novanm 4, 2024 1 reply

Updater beware. 1.0.15 totally broke my slider layout. They just all load vertically on top of each other now. Trying to diagnose/revert, but worth knowing in case it happens to you also. Update: Excellent customer service. Plugin has been fixed. Thank you.

elaborate Novanm 3, 2024 5 replies

Basic Gutenberg block that lets you manually assemble other Gutenberg blocks into a slider. There is a minor technical issue. I only see one of the two next/prev arrows, and that arrow overflows the page width by default when no padding or margin is applied to the slider. The plugin is limited in scope to only allow creating slides manually. That mirrors the scope of the built-in suite of Gutenberg blocks nicely, but one dynamic feature I think would be appropriate is to load a configurable number of blog posts dynamically, optionally with filters applied. The plugin author has been very quick to update the plugin, so this review may be outdated by the time you read it.

Read all 45 reviews

Contributors & Developers

“Carousel Slider Block for Gutenberg” is open source software. The following people have contributed to this plugin.

Virgildia

“Carousel Slider Block for Gutenberg” has been translated into 11 locales. Thank you to the translators for their contributions.

Translate “Carousel Slider Block for Gutenberg” into your language.

Interested in development?

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

Changelog

1.0.0

First release of the plugin.

1.0.1

Fixed lodash issue.

1.0.2

Updates for latest WP Gutenberg version. Fixed editor CSS.

1.0.3

Added autoplay settings.

1.0.4

Improved UI experience by using inner blocks controls. Added RTL option. Removed padding option. Updated slide block icon.

1.0.5

Added block.json. Improved carousel block layout in the editor. Updated slide block icon. Tested for WordPress 5.9.

1.0.6

Eliminated block margin CSS issue in slides.
Changed the style of the “Add slide” button.

1.0.7

Added responsive setting for slides to scroll at a time.

1.0.8

Small CSS improvements in the editor. Updated slick CSS stylesheet handle. Tested on WordPress 6.0.

1.0.9

Fixed error message on Widget Editor screen. Tested on WordPress 6.3.1.

1.0.10

Fixed lodash error with latest WordPress 6.4 update.

1.0.11

Fixed layout issue in rows.
Code refactoring.

1.0.12

Added tag dependency.

1.0.13

Reverted Slick init to working solution – outside the WP block build process.

1.0.14

Update CSS for image block centering.

1.0.15

Button block appender fix.

1.0.16

Fix slider init.

2.0.0

Introduced Carousel Slider v2 built on Swiper.js
Legacy blocks are still supported but can be upgraded to v2 via block transforms
Added settings to hide legacy blocks and legacy upgrade notices

2.0.1

Changed legacy block setting to “Show legacy blocks”, disabled by default.
CSS update for pagination margin.