Skip to content

Carousel widget

What it is

Cycles through a set of images as a slideshow, with configurable transition effects and timing.

Config fields

Images list (up to the configured maximum, currently 20)

Each image entry has:

FieldWhat it controlsExample
URLPublic URL of the image.https://example.com/slide1.jpg
Alt textOptional accessible label for this image.Product launch slide
↑ ↓ buttonsReorder images in the slideshow.
× buttonRemove this image from the list.
Validate images buttonPre-loads all URLs and flags broken ones with a red indicator.

Slideshow settings

FieldWhat it controlsExample
TransitionAnimation between slides. Options vary by build; typically fade or slide.fade
Fit ModeHow each image fills the tile: Contain, Cover, or Fill.Cover
AutoplayEnables automatic advancement. When off, the widget shows the first image statically.enabled
IntervalSeconds per slide when autoplay is on.5
Pause on hoverPauses the slideshow while the cursor is over the tile (useful during interactive review).enabled
Show dot indicatorsRenders a row of dots below the images indicating the current slide position.enabled

Common pitfalls

  • Broken image URLs are silent. A slide with a broken URL shows a blank frame — the slideshow continues without an error message. Use “Validate images” before saving to catch dead links.
  • CORS/hotlink blocking. Same constraint as the Image widget: images served with hotlink protection won’t load cross-origin. Host images on a permissive CDN.
  • Autoplay on display devices. Some browsers require a user gesture before playing media. Carousels use CSS/JS transitions, not <video>, so autoplay works reliably on all dotKiosk-supported targets.

Troubleshooting

SymptomTry
Blank slide in rotationClick “Validate images”; replace the broken URL.
Carousel not advancingCheck that “Autoplay” is enabled and the Interval is set to a positive value.
Images look croppedSwitch Fit Mode to “Contain” to show the full image with letterboxing.