Slider (nestable)
The Slider (nestable) element lets you build slides from editable Bricks elements. It uses Splide for slide navigation, autoplay, and, since Bricks 2.5, continuous auto scroll.
Settings
Section titled “Settings”- Children (nestable) - Drag and drop elements to create slider slides.
Options
Section titled “Options”-
Options type (select) - Use default settings or provide custom JSON options. Options:
default,custom. -
Custom options (code) - A Splide options object in JSON format. Shown when Options type is Custom. This replaces the options generated by the default controls, so include any autoplay or auto scroll settings you need in that object.
-
Type (select) - Slider behavior. Options:
loop,slide,fade. Default:loop. -
Direction (select) - Slide direction. Options:
left to right,right to left,vertical. Supports breakpoints. -
Keyboard (select) - Keyboard navigation. Options:
off,focused,global. Default:global. Supports breakpoints. -
Auto height (checkbox) - Adjust height to content. May cause layout shift. Using “Auto height” might lead to CLS (Cumulative Layout Shift).
-
Height (number with units) - Fixed slider height. Default: 50vh. Not available when auto height is enabled. Supports breakpoints.
-
Spacing (number with units) - Gap between slides. Default: 0. Supports breakpoints.
-
Start index (number) - Initial slide index. Default: 0.
-
Items to show (number) - Number of slides visible at once. Default: 1. Supports breakpoints. Not available for fade type.
-
Items to scroll (number) - Number of slides to scroll at once. Default: 1. Supports breakpoints. Not available for fade type.
-
Speed in ms (number) - Transition speed. Default: 400. Supports breakpoints.
-
Focus (number) - Determines which slide should be active if the carousel has multiple slides in a page. Number/“center”. Supports breakpoints.
Autoplay
Section titled “Autoplay”-
Autoplay (checkbox) - Enable automatic slide progression.
-
Pause on hover (checkbox) - Pause autoplay when hovering over slider.
-
Pause on focus (checkbox) - Pause autoplay when slider is focused.
-
Interval in ms (number) - Time between slides. Default: 3000.
Auto scroll
Section titled “Auto scroll”Auto scroll moves slides continuously. Autoplay advances from one slide to the next after an interval. For a continuous row of reviews or logos, use Auto scroll with Type → Loop and leave Autoplay disabled.
Auto scroll controls appear under Options when Options type is Default.
| Setting | Behavior | Default |
|---|---|---|
| Auto scroll | Enable continuous slide movement. | Disabled |
| Speed | Movement speed, adjustable in steps of 0.1. Positive and negative values move in opposite directions; 0 stops movement. This is separate from Speed in ms, which controls slide transitions. | 1 |
| Pause on hover | Pause while the pointer is over the slider. | Disabled |
| Pause on focus | Pause while focus is inside the slider. | Disabled |

The slider’s Direction setting selects the horizontal or vertical layout. Fade does not support auto scroll. The Auto scroll controls apply across screen sizes; they do not have separate breakpoint values. Custom JSON options can define breakpoint-specific behavior.
Autoplay and auto scroll stay off in the Builder so you can select and edit slide content. Save the page and view the frontend to check movement. This also applies when you use Custom options.
Add a Playback control so visitors can pause the slider. Pause on hover or focus alone does not provide a pause control for everyone.
Rewind
Section titled “Rewind”Available when type is not “loop”:
-
Rewind (checkbox) - Enable rewind functionality.
-
Rewind by drag (checkbox) - Allow rewinding by dragging.
-
Speed in ms (number) - Rewind transition speed.
Playback control
Section titled “Playback control”Since Bricks 2.5, Playback control → Show playback control adds a native pause/play button for autoplay and auto scroll. It is disabled by default. The button sits outside the moving slides and changes its label between Pause and Play.
Set your own labels in the Pause and Play fields. Use the controls in the same group to set typography, background, border, padding, and position.


With the native control enabled, keyboard focus entering the slider pauses playback until the visitor chooses Play. A deliberate pause remains in place after hovering, resizing, or updating the slider. Hover pauses are temporary when Pause on hover is enabled.
Bricks stops automatic movement when the visitor requests reduced motion and hides the native button when playback is unavailable. A Play action does not override the reduced-motion preference.
To use your own button, add a Slider playback interaction and target the slider. This can pause, resume, or toggle both autoplay and auto scroll.
-
Padding (spacing) - Padding inside slides.
-
Align horizontal (align-items) - Horizontal alignment of slide content. Options:
flex-start,center,flex-end. -
Align vertical (justify-content) - Vertical alignment of slide content. Options:
flex-start,center,flex-end,space-between,space-around. -
Background (background) - Background styling for slides.
-
Border (border) - Border styling for slides.
Arrows
Section titled “Arrows”-
Show (checkbox) - Display navigation arrows.
-
Height (number with units) - Arrow button height. Default: 50px.
-
Width (number with units) - Arrow button width. Default: 50px.
-
Background (color) - Arrow button background color.
-
Border (border) - Arrow button border styling.
-
Color (color) - Arrow icon color.
-
Size (number with units) - Arrow icon size.
-
Text shadow (text-shadow) - Text shadow for arrow icons.
Disabled
Section titled “Disabled”-
Background (color) - Background color for disabled arrows.
-
Border (border) - Border styling for disabled arrows.
-
Color (color) - Icon color for disabled arrows.
-
Opacity (number) - Opacity for disabled arrows (0-1).
Prev arrow
Section titled “Prev arrow”-
Prev arrow (icon) - Custom icon for previous arrow.
-
Top (number with units) - Top position. Default: 50%.
-
Right (number with units) - Right position.
-
Bottom (number with units) - Bottom position.
-
Left (number with units) - Left position.
-
Transform (transform) - CSS transform for previous arrow.
Next arrow
Section titled “Next arrow”-
Next arrow (icon) - Custom icon for next arrow.
-
Top (number with units) - Top position. Default: 50%.
-
Right (number with units) - Right position.
-
Bottom (number with units) - Bottom position.
-
Left (number with units) - Left position.
-
Transform (transform) - CSS transform for next arrow.
Pagination
Section titled “Pagination”-
Show (checkbox) - Display pagination dots. Default: enabled.
-
Margin (spacing) - Margin around pagination dots. Default: 5px on all sides.
-
Height (number with units) - Dot height. Default: 10px.
-
Width (number with units) - Dot width. Default: 10px.
-
Color (color) - Dot color and background color.
-
Border (border) - Border styling for dots.
Active
Section titled “Active”-
Height (number with units) - Height for active dot.
-
Width (number with units) - Width for active dot.
-
Color (color) - Color for active dot.
-
Border (border) - Border styling for active dot.
Was this helpful?
A quick vote and short notes help us improve these docs faster.
Leave a note for us
Please do not include passwords, license keys, or personal data. We store submitted notes to improve the docs.
Thanks for sharing feedback. We're using it to improve these docs.