carousel-usage
When to use
- Image galleries — multiple images browsable via arrows or dots. Use with image blocks as slides.
- Testimonial rotators — auto-playing quotes or reviews. Use with text or card blocks.
- Feature showcases — highlight multiple features one at a time in limited space.
- Product images — show multiple angles or variants of a product.
Key decisions
- Auto-play: Enable for ambient content (testimonials, brand imagery). Disable for content that requires reading.
- Navigation: carousel-nav-both (arrows + dots) for most cases. carousel-nav-dots for minimal UI.
- Looping: Enable for continuous browsing, disable if there is a clear start/end.
- Interval: Use 5s for text content, 3s for image-only slides.
carousel-options
All authoring options
Section decorator
filter: carousel
model: carousel
name: display name
Behavior
classes_carouselAutoplay: boolean (auto-advance slides)
classes_carouselInterval: carousel-interval-3s | carousel-interval-5s | carousel-interval-8s
classes_carouselLoop: boolean (loop after last slide)
Navigation
classes_carouselNav: carousel-nav-arrows | carousel-nav-dots | carousel-nav-both | carousel-nav-none
Analytics
trackInview: boolean
trackInviewMeta: text