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:
| Field | What it controls | Example |
|---|---|---|
| URL | Public URL of the image. | https://example.com/slide1.jpg |
| Alt text | Optional accessible label for this image. | Product launch slide |
| ↑ ↓ buttons | Reorder images in the slideshow. | |
| × button | Remove this image from the list. | |
| Validate images button | Pre-loads all URLs and flags broken ones with a red indicator. |
Slideshow settings
| Field | What it controls | Example |
|---|---|---|
| Transition | Animation between slides. Options vary by build; typically fade or slide. | fade |
| Fit Mode | How each image fills the tile: Contain, Cover, or Fill. | Cover |
| Autoplay | Enables automatic advancement. When off, the widget shows the first image statically. | enabled |
| Interval | Seconds per slide when autoplay is on. | 5 |
| Pause on hover | Pauses the slideshow while the cursor is over the tile (useful during interactive review). | enabled |
| Show dot indicators | Renders 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
| Symptom | Try |
|---|---|
| Blank slide in rotation | Click “Validate images”; replace the broken URL. |
| Carousel not advancing | Check that “Autoplay” is enabled and the Interval is set to a positive value. |
| Images look cropped | Switch Fit Mode to “Contain” to show the full image with letterboxing. |