Kindly EditDocumentationTry the editor

Image carousel

Pictures in a row that people can swipe or step through.

Use this element#

Use a carousel for a sequence of images. Replace each slide’s picture and caption, choose how many slides are visible, and give the carousel a descriptive accessible name.

Automatic movement can be off or advance every 3, 5, or 8 seconds. Visitors can step or swipe through the sequence. Inspect the public behavior with reduced motion and keyboard input. Essential information should not rely on a visitor waiting for a later slide.

Availability#

Available through the appropriate content or section picker when the theme and editing context allow it.

Content controls#

These are the controls registered for this element. A control that depends on another setting or the surrounding layout appears only when it applies.

Slides in view#

Choice Stored value
1 (empty/default)
2 cb-show-2
3 cb-show-3

Moves on by itself#

Choice Stored value
No 0
Every 3 seconds 3000
Every 5 seconds 5000
Every 8 seconds 8000

Slides#

Use Add a slide to create a complete item. The collection manages its content and structural wrapper together.

Min: 1.

Each item exposes: Caption. Rich content can also be edited directly on the page.

The item includes a picture that can be replaced through the image controls.

Name for screen readers#

Input type: text. Enter the desired value, then check the page result.

Style controls#

In Developer mode, Style starts with this element's own group, Carousel, open above the shared Style groups (available in 0.9.15 and later):

Control Value
Arrow background Color
Arrow color Color
Active indicator color Color

Each works like the rest of the inspector: it starts by showing the element's current look, Reset brings the theme's value back, and each change is one Undo step. Like other Style settings, a value can differ by screen size and state (Normal, Hover, Focus).

Save and check#

  1. Change one setting and inspect the affected element.
  2. Use Undo and Redo to check the edit is reversible.
  3. Save a draft, reopen it, and confirm the content and choices remain.
  4. Inspect the page at desktop and phone widths.
  5. Publish only when the result is ready. For interactive elements, check the visitor view because editing mode can suppress interaction.

How it is stored#

The block comes from blocks/410-carousel.html. Its editable content is HTML in the page or owning template. Native settings update words, attributes, classes, or supported style properties. Generated interface controls are not saved into that HTML.

The settings registry matches .cb-carousel in assets/element-settings.js. Public behavior, when needed, is implemented by the native element runtime in assets/elements.js or assets/blocks.js.

About this page

Documents Kindly Edit 0.9.16. Source: blocks/410-carousel.html, assets/element-settings.js, assets/elements.js. Theme choices and account permissions can change which controls appear.

Type a word or phrase to search the full documentation.