Docs

Carousel

A swipeable carousel whose slides can hold any widgets.

On this page

The Carousel shows a row of slides that visitors swipe, drag or page through with arrows. Every slide is a container, so a slide can be a project card, a quote, a team member or any mix of widgets. For a row of plain images use Image Carousel; for a full-width hero slider use Slides.

A carousel showing three of four project cards, each with an image, a title and a short description, with dots and arrows below
Three slides per view, with the arrows below next to the dots.
  1. Insert it

    Open Insert in the left panel, find Carousel under Layout (or type carousel in Search widgets) and click it or drag it onto the canvas. It starts with three slides.

  2. Manage the slides

    In Content → Slides, Add item adds a slide; drag the handle to reorder, or use Duplicate item and Delete item. Give each slide a Label so you can find it in Layers.

  3. Build each slide

    Drop widgets into the slide containers on the canvas. To bring a slide into view, select it (or anything inside it) in Layers.

  4. Set how many slides show

    In Content → Carousel, set Slides per view and Gap. Switch the device in the top bar to show fewer slides on tablet and mobile.

Settings

Settings marked Per device can differ on desktop, tablet and mobile (see Responsive editing).

Content tab

Slides
SettingWhat it does
SlidesThe list of slides. Each slide is a container on the canvas that can hold any widgets. Add item, drag to reorder, Duplicate item and Delete item keep the slides in step.
Each slide
SettingWhat it does
LabelName of the slide in this list and in Layers.
Carousel
SettingWhat it does
Slides per viewHow many slides show at once. Decimals such as 1.2 let the next slide peek in. Per device.
Slides to scrollHow many slides one arrow click or swipe moves. Per device.
GapSpace between the slides. Per device.
Vertical alignmentHow slides of different heights line up. Options: Equal height, Top, Middle, Bottom.
Navigation › ArrowsShows previous and next buttons. On by default.
Navigation › Arrows positionWhere the arrows sit. Options: Inside, over the slides, Outside the slides, Below, next to the pagination. Default: Inside, over the slides. Shown when Arrows is on.
Navigation › Previous iconIcon of the previous button. Shown when Arrows is on.
Navigation › Next iconIcon of the next button. Shown when Arrows is on.
Navigation › PaginationThe position indicator under the slides. Options: None, Dots, Fraction (2 / 5), Progress bar. Default: Dots.
Navigation › RewindNext on the last slide goes back to the first one.
Navigation › Mouse dragLets visitors drag the slides with the mouse. Touch swipe and trackpads always work. On by default.
Navigation › Transition duration (ms)How long the move to the next slide takes, in milliseconds. Default: 500.
Autoplay › AutoplayMoves to the next slide on its own. Never starts for visitors who prefer reduced motion; pauses while hovered or focused.
Autoplay › Delay (ms)Time each slide stays, in milliseconds. Default: 5000. Shown when Autoplay is on.
Autoplay › Pause on hoverStops autoplay while the pointer is over the carousel. On by default. Shown when Autoplay is on.
Autoplay › Pause buttonAdds a pause/play button. Required by WCAG 2.2.2 for content that moves on its own. On by default. Shown when Autoplay is on.
Autoplay › Accessible nameName of the carousel for screen readers, for example “Customer stories”.

Design tab

Slides
SettingWhat it does
BackgroundBackground of each slide.
BorderBorder of each slide.
Border radiusRounds the corners of each slide. Per device.
PaddingSpace inside each slide. Per device.
ShadowShadow of each slide.
Arrows

This section shows when Arrows is on.

SettingWhat it does
Button sizeWidth and height of the arrow buttons. Per device.
Icon sizeSize of the arrow icons. Per device.
OffsetDistance of the arrows from the edge of the slides (inside or outside), or between the two arrows (below). Per device.
Normal › Icon colorColor of the arrow icons.
Normal › BackgroundBackground color of the arrow buttons.
Normal › BorderBorder of the arrow buttons.
Normal › ShadowShadow of the arrow buttons.
Hover › Icon colorColor of the arrow icons on hover.
Hover › BackgroundBackground color of the arrow buttons on hover.
Hover › Border colorBorder color of the arrow buttons on hover.
Border radiusRounds the corners of the arrow buttons. Per device.
Pagination

This section shows when Pagination is set.

SettingWhat it does
Distance from slidesSpace between the slides and the pagination. Per device.
AlignmentAligns the pagination. Options: Left, Center, Right. Per device.
Dot sizeSize of the dots. Shown when Pagination is Dots.
Active dot widthWidth of the current dot. Same as the dot size for round dots, wider for a pill. Shown when Pagination is Dots.
Space between dotsSpace between the dots. Shown when Pagination is Dots.
Dot colorColor of the dots. Shown when Pagination is Dots.
Active dot colorColor of the current dot. Shown when Pagination is Dots.
TypographyText style of the “2 / 5” counter. Shown when Pagination is Fraction (2 / 5).
ColorColor of the “2 / 5” counter. Shown when Pagination is Fraction (2 / 5).
Bar heightHeight of the progress bar. Shown when Pagination is Progress bar.
Bar colorColor of the filled part of the progress bar. Shown when Pagination is Progress bar.
Track colorColor of the empty part of the progress bar. Shown when Pagination is Progress bar.
Pause button colorColor of the pause/play button. Shown when Autoplay is on.
Shared Design sections

Every element also has these sections at the end of the Design tab.

SectionWhat it does
Spacing & positionMargin, padding, width, alignment in its container, order, position (relative, absolute, fixed), offsets, z-index and global classes. See Spacing, size & position.
Background & borderBackground, border, border radius, box shadow, overflow and opacity of the whole element. See Colors & backgrounds and Borders & shadows.
MaskCrops the element to a shape (circle, arch, blob, star…) or your own SVG or PNG. See Shape dividers & masks.

Behaviour tab

Behaviour sections

The Behaviour tab is the same for every element.

SectionWhat it does
Anchor & classesAn Anchor ID for #links and your own CSS classes.
AnimationsEntrance, scroll, hover and loop animations from presets or your own timeline. See Motion & effects.
Motion & effectsA simple entrance animation, transforms (also on hover), CSS and backdrop filters, and sticky positioning.
Scroll & mouse effectsMovement, rotation, scale, fade and blur while the page scrolls, and pointer effects (follow the pointer, 3D tilt).
VisibilityHide the element on desktop, tablet or mobile, or in dark or light mode. See Visibility.
ConditionsShow the element only when rules match, such as logged-in visitors, a date range or a URL parameter. See Display conditions.
InteractionsShow, hide or change other elements when this one is clicked, hovered or scrolled into view. See Interactions.
AttributesCustom HTML attributes for this element. See Anchor, classes & attributes.

Tips

  • Show a peek. A Slides per view of 1.2 on mobile shows part of the next slide, which tells visitors they can swipe.
  • Use autoplay sparingly. Moving content is harder to read. If you turn on Autoplay, keep the Pause button; it is required for accessibility (WCAG 2.2.2). Autoplay never starts for visitors who prefer reduced motion and pauses while the pointer or keyboard focus is on the carousel.
  • Name it. Fill in Accessible name (for example “Recent projects”) so screen reader users know what the carousel holds. Keyboard users can move with the arrow keys, Home and End on the carousel's controls.
  • Equal heights. Keep Vertical alignment on Equal height for cards, so buttons line up.