Carousel Slider Block for Gutenberg

Descripción

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

Características

  • Agrega diapositivas ilimitadas
  • Añadie cualquier bloque a las diapositivas
  • Vista previa del carrusel en el editor
  • Adaptable y compatible con toques
  • Developer friendly: supports CSS variables & theme.json

Ajustes

  • Diapositivas por vista
  • Diapositivas que hacen desplazamiento al mismo tiempo
  • Velocidad de desplazamiento
  • Relleno de diapositivas
  • Flechas de anterior/siguiente
  • Navegación por puntos
  • Blucle de diapositivas infinito
  • Reproducción automática
  • Pause on hover
  • Disable on interaction
  • Ajustes de adaptabilidad: diapositivas a mostrar y desplazarse en un tamaño de pantalla dado
  • 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).

Requisitos

Recomendamos PHP 5.6+, WordPress 5.8+, con Gutenberg activo.

Documentación

Full documentation: carouselblock.com/docs

Selecciona el bloque de carrusel de diapositivas desde la categoría de diseño. Haz clic en el botón + situado al final del carrusel para agregar diapositivas. Agrega cualquier bloque dentro de las diapositivas. Usa la barra de desplazamiento horizontal para previsualizar las diapositivas en el editor.

Puedes reordenar las diapositivas usando los botones de flecha izquierda y derecha de la barra de herramientas.

Para quitar una diapositiva selecciona la diapositiva y haz clic en los tres puntos de la derecha sobre la misma. Haz clic en la opción de eliminar esa diapositiva.

Haz clic en el bloque de carrusel (el bloque que anida todas las diapositivas) para mostrar los ajustes del carrusel.

Upgrading from Legacy Carousel

See the support topic 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

Navegación

  • --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)

Espaciado del bloque

  • --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.

Capturas de pantalla

  • Agrega cualquier bloque a las diapositivas del carrusel
  • Hero sliders
  • Testimonials and logo carousel
  • Ajustes del carrusel
  • Carousel editor

Bloques

Este plugin proporciona 2 bloques.

  • Carousel Slider Display a carousel using any blocks as slides.
  • Slide A single slide within the carousel.

Instalación

  1. Desde tu escritorio de WordPress, ve a Plugins > Agregar nuevo.
  2. Busca Carousel Slider Block en la caja Buscar plugins.
  3. Haz clic en Instalar ahora para instalar el plugin Carousel Slider Block.
  4. Haz clic en Activar para activar el plugin.
  5. El bloque de carrusel de diapositivas se agregará al grupo de bloques de diseño en el editor.

Si aún necesitas ayuda, visita Codex de WordPress

FAQ

¿Qué es Gutenberg?

Gutenberg es el nombre del nuevo editor basado en bloques introducido en WordPress 5. Gutenberg facilita crewar contenido dentro del editor usando bloques.

¿Cómo agrego un carrusel a WordPress?

Seleciona el bloque de carrusel de diapositivas desde la categoría de diseño.

¿Cómo agrego una diapositiva a WordPress?

Selecciona el bloque de carrusel de diapositivas. Haz clic en el botón + para agregar diapositivas al carrusel.

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.

Reseñas

6 de Septiembre de 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.
16 de Julio de 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
6 de Junio de 2025
I love how simple and straightforward it is. The block is really versatile. Support was great too when I made a post!
14 de Marzo de 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.
Leer los 49 comentarios

Colaboradores & Desarrolladores

“Carousel Slider Block for Gutenberg” es software de código abierto. Las siguientes personas han contribuido a este plugin.

Colaboradores

“Carousel Slider Block for Gutenberg” ha sido traducido en 12 idiomas. Gracias a los traductores por sus contribuciones.

Traduce “Carousel Slider Block for Gutenberg” a tu idioma.

¿Interesado en el desarrollo?

Revisa el código, echa un vistazo al repositorio SVN, o suscríbete al registro de desarrollo por RSS .

Historial de cambios

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

Actualiza las CSS para centrar bloques de imágenes.

1.0.13

Se revirtió Slick init a una solución funcional, fuera del proceso de construcción del bloque WP.

1.0.12

Agregada la dependencia de etiquetas.

1.0.11

Corregido el problema de diseño en filas.
Código de reprogramación.

1.0.10

Corregido el error de “lodash” con la última actualización de WordPress 6.4.

1.0.9

Corregido el mensaje de error en la pantalla del editor de widgets. Probado en WordPress 6.3.1.

1.0.8

Pequeñas mejoras de CSS en el editor. Se actualizó el uso de la hoja de estilos CSS. Probado en WordPress 6.0.

1.0.7

Agregado un conjunto adaptable para que las diapositivas se desplacen a la vez.

1.0.6

Se eliminó el problema de CSS con margen de bloque en las diapositivas.
Se cambió el estilo del botón “Agregar diapositiva”.

1.0.5

Se agregó “block.json”. Diseño de bloque de carrusel mejorado en el editor. Ícono de bloque de diapositiva actualizado. Probado para WordPress 5.9.

1.0.4

Experiencia de usuario mejorada mediante el uso de controles de bloques internos. Agregada la opción RTL. Eliminada la opción de relleno. Actualizado el ícono de bloque diapositiva.

1.0.3

Agregado los ajustes de la reproducción automática.

1.0.2

Actualización para la última versión de WP Gutenberg. Corregido el editor de CSS.

1.0.1

Corregido el problema de “lodash”.

1.0.0

Primera versión del plugin.