Title: Carousel Slider Block for Gutenberg Author: Virgildia Published: February 3, 2019 Last modified: March 26, 2026 --- Search plugins ![](https://ps.w.org/carousel-block/assets/banner-772x250.png?rev=2024115) ![](https://ps.w.org/carousel-block/assets/icon.svg?rev=2024115) # Carousel Slider Block for Gutenberg By [Virgildia](https://profiles.wordpress.org/virgildia/) [Download](https://downloads.wordpress.org/plugin/carousel-block.2.1.1.zip) * [Details](https://en-ca.wordpress.org/plugins/carousel-block/#description) * [Reviews](https://en-ca.wordpress.org/plugins/carousel-block/#reviews) * [Installation](https://en-ca.wordpress.org/plugins/carousel-block/#installation) * [Development](https://en-ca.wordpress.org/plugins/carousel-block/#developers) [Support](https://wordpress.org/support/plugin/carousel-block/) ## Description A responsive modern carousel slider for the Gutenberg block editor that lets you add any blocks to your slides. Easily create sliders for hero sections, testimonials, products, and anything else using Gutenberg blocks. 🚀 **Carousel Slider Version 2** is built on the modern Swiper.js library for improved performance and better mobile compatibility. Plugin site: [carouselblock.com](https://www.carouselblock.com/) #### Features * Add unlimited slides * Add any blocks to the slides * Preview the carousel in the editor * Responsive and touch enabled * Developer friendly: supports CSS variables & theme.json #### Settings * Slides per view * Slides to scroll at a time * Slide speed * Slide padding * Prev/next arrows * Dots navigation * Infinite loop sliding * Autoplay * Pause on hover * Disable on interaction * Responsive settings: slides to show and scroll at given screen size * RTL #### Advanced Settings For dynamic layouts where the slider or its surrounding layout changes after load, such as tabs, accordions, or lazy-loaded content. * ResizeObserver * Observer * Observe parent elements * Observe slide children #### Included Patterns * Full Width Hero Slider * Testimonials Slider * Logos Carousel The final look of these sliders depends on your theme styles. You can also fine- tune the design using custom CSS variables (see below). ### Requirements PHP 5.6+ is recommended, WordPress 5.8+, with Gutenberg active. ### Documentation Full documentation: [carouselblock.com/docs](https://www.carouselblock.com/docs) 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. #### Upgrading from Legacy Carousel See the [support topic](https://wordpress.org/support/topic/how-to-update-to-carousel-slider-block-version-2/) for upgrading legacy blocks to Carousel Slider Version 2. Legacy settings remain available at `/wp-admin/options-general.php?page=cb-carousel- settings`. The page is hidden from the admin menu and can be accessed directly by URL. ### Customizing Styles Carousel Slider v2 supports custom styling via CSS variables: Styling documentation: [carouselblock.com/docs?doc=styling](https://www.carouselblock.com/docs?doc=styling) #### Navigation * `--wp--custom--carousel-block--navigation-size`: Arrow icon size * `--wp--custom--carousel-block--navigation-sides-offset`: Distance from edge * `--wp--custom--carousel-block--navigation-color`: Arrow color * `--wp--custom--carousel-block--navigation-hover-color`: Arrow hover color (falls back to `navigation-color`) * `--wp--custom--carousel-block--navigation-alignfull-color`: Arrow color when carousel is full width #### Pagination (dots) * `--wp--custom--carousel-block--pagination-top`: Top offset * `--wp--custom--carousel-block--pagination-bottom`: Bottom offset * `--wp--custom--carousel-block--pagination-bullet-size`: Bullet size * `--wp--custom--carousel-block--pagination-bullet-active-color`: Active bullet color * `--wp--custom--carousel-block--pagination-bullet-inactive-color`: Inactive bullet color * `--wp--custom--carousel-block--pagination-bullet-inactive-hover-color`: Inactive bullet hover color (falls back to `active-color` if set) * `--wp--custom--carousel-block--pagination-bullet-active-opacity`: Active bullet opacity * `--wp--custom--carousel-block--pagination-bullet-inactive-opacity`: Inactive bullet opacity * `--wp--custom--carousel-block--pagination-bullet-inactive-hover-opacity`: Inactive bullet opacity on hover (falls back to `inactive-opacity` if not set) * `--wp--custom--carousel-block--pagination-bullet-horizontal-gap`: Space between bullets (horizontal) * `--wp--custom--carousel-block--pagination-bullet-vertical-gap`: Space between bullets (vertical) #### Block Spacing * `--wp--custom--carousel-block--image-margin-top`: Top margin for image blocks * `--wp--custom--carousel-block--image-margin-bottom`: Bottom margin for image blocks * `--wp--custom--carousel-block--cover-margin-top`: Top margin for cover blocks * `--wp--custom--carousel-block--cover-margin-bottom`: Bottom margin for cover blocks ### Theme JSON Support All the CSS variables can also be defined directly inside your theme’s `theme.json` under the `settings.custom` key. For example: ``` { "settings": { "custom": { "carousel-block": { "navigation-size": "22px", "navigation-color": "#000", "pagination-bullet-active-color": "#000" } } } } ``` ### Frontend API Carousel Slider exposes a small frontend API for integrations with tabs, accordions, modals, or other hidden UI. For some of these dynamic layout cases, the Advanced Settings observer options can also handle updates automatically. * `window.CarouselSliderBlock.init( container )`: Initializes carousel instances inside the given container. * `window.CarouselSliderBlock.update( container )`: Updates existing carousel instances inside the given container and initializes any that are not yet initialized. ## Screenshots * [[ * Add any blocks to the carousel slides * [[ * Hero sliders * [[ * Testimonials and logo carousel * [[ * Carousel settings * [[ * Carousel editor ## Blocks This plugin provides 2 blocks. * Carousel Slider Display a carousel using any blocks as slides. * Slide A single slide within the carousel. ## Installation 1. From your WordPress dashboard go to **Plugins > Add New**. 2. Search for **Carousel Slider Block** in the **Search Plugins** box. 3. Click **Install Now** to install the **Carousel Slider Block** Plugin. 4. Click **Activate** to activate the plugin. 5. **Carousel Slider Block** will be added to the **Design** block group in the editor. If you still need help. visit [WordPress codex](https://codex.wordpress.org/Managing_Plugins#Installing_Plugins) ## 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. ### How do I add an image carousel in Gutenberg? Add the Carousel Slider block from the block inserter and upload images or create slides inside the block. Each slide can contain images, text, or other blocks. ### Can I add multiple carousels on the same page? Yes. You can add multiple Carousel Slider blocks to a page or post and each carousel will work independently. ### Can I add images and text inside carousel slides? Yes. Each slide can contain images, text, buttons, or other blocks depending on how you want to design your carousel. ### Is the carousel mobile friendly? Yes. The carousel is fully responsive and works on mobile phones, tablets, and desktop devices. ### Can I use the carousel in posts and pages? Yes. The Carousel Slider block works in both WordPress posts and pages anywhere the block editor is available. ### How can I make the carousel performant in WordPress? The Carousel Slider block uses the lightweight Swiper library for fast and smooth performance. For best results, use optimized images and enable lazy loading on any Image blocks inside slides so images load only when needed. ### How do I make the slider update inside tabs, accordions, modals, or other dynamic layouts? Use the Advanced Settings observer options when the slider or its surrounding layout changes after load. For custom integrations, you can also call `window.CarouselSliderBlock. init( container )` or `window.CarouselSliderBlock.update( container )` after the layout changes. ### Why does the plugin use Swiper.js? The Carousel Slider block uses the lightweight Swiper.js library because it provides fast, smooth, and responsive sliders. Swiper is widely used, mobile-friendly, and optimized for performance. ### How do I add a slider to WordPress without coding? Install the Carousel Slider plugin and add the Carousel Slider block to your page or post using the block editor. ## Reviews ![](https://secure.gravatar.com/avatar/c1dc66380ef5f73a720b84dda345e0420b5e38698c9c9bab23ae89930758f211? s=60&d=retro&r=g) ### 󠀁[Great plugin with the right amount of customization](https://wordpress.org/support/topic/great-plugin-with-the-right-amount-of-customization/)󠁿 [ivanbachev](https://profiles.wordpress.org/ivanbachev/) April 2, 2026 Perfect option if you need a solution that is well integrated with Gutenberg. ![](https://secure.gravatar.com/avatar/e0ba1d0a1b683e686a07e412f865e44e348ff7934b54684e7b0fe2cab7ab7b0b? s=60&d=retro&r=g) ### 󠀁[Lovely little plugin](https://wordpress.org/support/topic/lovely-little-plugin-6/)󠁿 [Aurovrata Venet](https://profiles.wordpress.org/aurovrata/) September 6, 2025 Thank you for a great little plugin. It handles slides really well and the block settings are intuitive and allows for a lot of style variations and layouts. I have a few ideas on how to further improve it. Is is on GitHub? I’d like to do a PR to contribute some code. Some ideas for improvement: – allow the slides to pause on mouse hover over the arrows or pagination dots. – enable custom navigation by allowing a custom element with the right css to listen for click events. ![](https://secure.gravatar.com/avatar/e69bad7ba83c109f4e8c995df9706964d014afa67d1000e11b9f402e171baf3a? s=60&d=retro&r=g) ### 󠀁[Simple, yet very flexible slider that is easy to use](https://wordpress.org/support/topic/simple-yet-very-flexible-slider-that-is-easy-to-use/)󠁿 [pharrisonw](https://profiles.wordpress.org/pharrisonw/) July 16, 2025 This slider operates as a block inserted on a page/post. It them accepts other Gutenberg blocks, (text, image, header, etc.) as content for the slider. All controls for the slider are on the block itself. Save as a pattern to repeat the configured slider on other pages.This is a very simple yet flexible plugin. Highly recommended ![](https://secure.gravatar.com/avatar/11f14c461e19cada8a6ad3d506676f4b692592b5b4791e9f4c3c010b2d80e4e7? s=60&d=retro&r=g) ### 󠀁[Love this block](https://wordpress.org/support/topic/love-this-block/)󠁿 [annaise](https://profiles.wordpress.org/annaise/) June 6, 2025 I love how simple and straightforward it is. The block is really versatile. Support was great too when I made a post! ![](https://secure.gravatar.com/avatar/6191787028e321ca40e548d3595aab22ea54ec6049b5490c2b87710fc55c974d? s=60&d=retro&r=g) ### 󠀁[Yeah for simple, free, and open source slider block!](https://wordpress.org/support/topic/yeah-for-simple-free-and-open-source-slider-block/)󠁿 [efficiondave](https://profiles.wordpress.org/efficiondave/) May 3, 2025 A great and simple plug-in. Exactly what I wanted. ![](https://secure.gravatar.com/avatar/7848873a96b8314991ace9649b71b1ee4eeb2bfbdda11a222922ee3e79878706? s=60&d=retro&r=g) ### 󠀁[Does what it says. Awesome](https://wordpress.org/support/topic/does-what-it-says-awesome/)󠁿 [BobRebus](https://profiles.wordpress.org/bobrebus/) March 24, 2025 Does what it says. Simple and practical, easy to use. Thank you for creating this! [ Read all 50 reviews ](https://wordpress.org/support/plugin/carousel-block/reviews/) ## Contributors & Developers “Carousel Slider Block for Gutenberg” is open source software. The following people have contributed to this plugin. Contributors * [ Virgildia ](https://profiles.wordpress.org/virgildia/) “Carousel Slider Block for Gutenberg” has been translated into 12 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/carousel-block/contributors) for their contributions. [Translate “Carousel Slider Block for Gutenberg” into your language.](https://translate.wordpress.org/projects/wp-plugins/carousel-block) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/carousel-block/), check out the [SVN repository](https://plugins.svn.wordpress.org/carousel-block/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/carousel-block/) by [RSS](https://plugins.trac.wordpress.org/log/carousel-block/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 2.1.1 * Improved PHP 8+ compatibility for the hidden settings page #### 2.1.0 * Added starter carousel patterns for hero, testimonials, and logos #### 2.0.10 * Stability fix #### 2.0.9 * Hid the legacy settings page from the admin menu while keeping direct URL access at `/wp-admin/options-general.php?page=cb-carousel-settings` * Added advanced Swiper observer settings and updated documentation * Increased default vertical spacing for navigation dots #### 2.0.8 * Simplified the labels in the editor panel * Removed “v2” from block titles and added “v1” to legacy blocks #### 2.0.7 * Added pauseOnMouseEnter and disableOnInteraction to autoplay settings * Exposed frontend carousel init() and update() APIs for tabs, accordions, and other hidden UI. #### 2.0.6 Additional CSS variables #### 2.0.5 Fix block insert #### 2.0.4 * Fix for hide legacy option * Update plugin description #### 2.0.3 Removed block.json from legacy blocks #### 2.0.2 * Added custom CSS variable for pagination bullet gap * Corrected documentation for navigation color variable * Removed unnecessary max-width property blocking inner block widths in editor #### 2.0.1 * Changed legacy block setting to “Show legacy blocks”, disabled by default * CSS update for pagination margin #### 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 #### 1.0.16 Fix slider init. #### 1.0.15 Button block appender fix. #### 1.0.14 Update CSS for image block centering. #### 1.0.13 Reverted Slick init to working solution – outside the WP block build process. #### 1.0.12 Added tag dependency. #### 1.0.11 Fixed layout issue in rows. Code refactoring. #### 1.0.10 Fixed lodash error with latest WordPress 6.4 update. #### 1.0.9 Fixed error message on Widget Editor screen. Tested on WordPress 6.3.1. #### 1.0.8 Small CSS improvements in the editor. Updated slick CSS stylesheet handle. Tested on WordPress 6.0. #### 1.0.7 Added responsive setting for slides to scroll at a time. #### 1.0.6 Eliminated block margin CSS issue in slides. Changed the style of the “Add slide” button. #### 1.0.5 Added block.json. Improved carousel block layout in the editor. Updated slide block icon. Tested for WordPress 5.9. #### 1.0.4 Improved UI experience by using inner blocks controls. Added RTL option. Removed padding option. Updated slide block icon. #### 1.0.3 Added autoplay settings. #### 1.0.2 Updates for latest WP Gutenberg version. Fixed editor CSS. #### 1.0.1 Fixed lodash issue. #### 1.0.0 First release of the plugin. ## Meta * Version **2.1.1** * Last updated: **1 week ago** * Active installations: **40,000+** * WordPress Version: ** 6.1 or higher ** * Tested up to: **6.9.4** * Language: * [Chinese (Taiwan)](https://tw.wordpress.org/plugins/carousel-block/), [Czech](https://cs.wordpress.org/plugins/carousel-block/), [Danish](https://da.wordpress.org/plugins/carousel-block/), [Dutch](https://nl.wordpress.org/plugins/carousel-block/), [English (US)](https://wordpress.org/plugins/carousel-block/), [French (France)](https://fr.wordpress.org/plugins/carousel-block/), [Galician](https://gl.wordpress.org/plugins/carousel-block/), [Norwegian (Bokmål)](https://nb.wordpress.org/plugins/carousel-block/), [Persian](https://fa.wordpress.org/plugins/carousel-block/), [Portuguese (Brazil)](https://br.wordpress.org/plugins/carousel-block/), [Russian](https://ru.wordpress.org/plugins/carousel-block/), [Spanish (Chile)](https://cl.wordpress.org/plugins/carousel-block/), and [Spanish (Spain)](https://es.wordpress.org/plugins/carousel-block/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/carousel-block) * Tags: * [carousel](https://en-ca.wordpress.org/plugins/tags/carousel/)[gutenberg](https://en-ca.wordpress.org/plugins/tags/gutenberg/) [Slide](https://en-ca.wordpress.org/plugins/tags/slide/)[swiper](https://en-ca.wordpress.org/plugins/tags/swiper/) * [Advanced View](https://en-ca.wordpress.org/plugins/carousel-block/advanced/) ## Ratings 4.8 out of 5 stars. * [ 44 5-star reviews ](https://wordpress.org/support/plugin/carousel-block/reviews/?filter=5) * [ 4 4-star reviews ](https://wordpress.org/support/plugin/carousel-block/reviews/?filter=4) * [ 1 3-star review ](https://wordpress.org/support/plugin/carousel-block/reviews/?filter=3) * [ 1 2-star review ](https://wordpress.org/support/plugin/carousel-block/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/carousel-block/reviews/?filter=1) [Add my review](https://wordpress.org/support/plugin/carousel-block/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/carousel-block/reviews/) ## Contributors * [ Virgildia ](https://profiles.wordpress.org/virgildia/) ## Support Issues resolved in last two months: 7 out of 8 [View support forum](https://wordpress.org/support/plugin/carousel-block/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](http://virgiliudiaconu.com/)