Settings
All carousel settings are available in the block settings sidebar (right panel) when the Carousel Slider Block is selected in the editor.
General
| Setting | Description | Default |
|---|---|---|
| Slides per view | How many slides are visible at once | 1 |
| Slides per group | How many slides advance per navigation step | 1 |
| Space between | Gap between slides in pixels | 15 |
| Loop | Enable infinite looping | true |
| Autoplay | Automatically advance slides | false |
| Autoplay speed (ms) | Transition speed for autoplay slide movement | 300 |
| Pause on mouse enter | Pause autoplay when the user hovers over the carousel | false |
| Disable on interaction | Stop autoplay after user interaction | false |
Navigation
| Setting | Description | Default |
|---|---|---|
| Show arrows | Display previous/next chevron buttons | true |
| Show dots | Display pagination dot indicators | true |
Responsive Breakpoints
Configure a responsive breakpoint to override carousel behaviour once the viewport reaches a specific width.
| Setting | Description | Default |
|---|---|---|
| Breakpoint width (px) | Minimum viewport width where the responsive settings apply | 768 |
| Slides per view | How many slides are visible at that breakpoint | 3 |
| Slides per group | How many slides advance per navigation step at that breakpoint | 1 |
Advanced
These are the standard Gutenberg advanced options for the block.
| Setting | Description |
|---|---|
| HTML anchor | Add an HTML anchor ID for linking directly to the block |
| Additional CSS class(es) | Add custom CSS classes when the active theme supports it |
| ResizeObserver | Use the browser ResizeObserver API to react to carousel container size changes |
| Observer | Update the carousel when it is changed by DOM mutations |
| Observe parents | Update the carousel when parent elements change |
| Observe slide children | Update the carousel when slide child elements change |
ResizeObserver uses the browser's native ResizeObserver API so Swiper can react to carousel container size changes more reliably, not just window resize events. In most cases this improves layout updates in responsive or dynamic layouts, but you can disable it if a theme or plugin causes compatibility issues.