Skip to main content
Carousel endpoints allow you to generate URLs that display rotating marketing slides on customer-facing screens. This enables you to show dynamic promotional content, offers, and announcements in a visually engaging format. A carousel is a rotating slideshow of marketing content displayed on customer-facing screens (CFS) or kiosk displays. Carousels help you:
  • Display Multiple Offers: Rotate through several promotions in one screen space
  • Increase Engagement: Catch customer attention with dynamic visual content
  • Promote Campaigns: Showcase seasonal offers, new products, or events
  • Brand Awareness: Display brand messaging and marketing materials

​
How It Works

Generate Carousel URL

Call the carousel endpoint with your location and terminal information.

Receive URL

API returns a unique URL pointing to the carousel content configured for your location.

Display on Screen

Load the carousel URL in a web view or browser on your customer-facing screen or kiosk.

Content Auto-Updates

Carousel content updates automatically based on your ClearLine admin configuration - no need to regenerate the URL.

Generate Carousel URL

Generate a URL for carousel content display

​
Best Practices

Generate Once Per Session

Generate the carousel URL once when your CFS/kiosk initializes. The URL remains valid and content updates automatically.
Display the carousel in a full-screen web view for maximum visual impact on customer-facing screens.
Implement fallback content (static image or message) if the carousel URL fails to load due to network issues.
Regenerate the carousel URL daily or when restarting your display to ensure you have the latest configuration.

​
Common Use Cases

Retail Stores: Display rotating product promotions, seasonal offers, and store announcements on screens at checkout or entrance. Restaurants: Show menu specials, combo deals, and promotional offers on customer-facing displays at the counter. Service Businesses: Promote loyalty programs, new services, and special pricing on waiting area screens. Kiosks: Attract customers with dynamic marketing content on self-service kiosk idle screens.

​
Next Steps

Carousel API Reference

View complete API specification

CFS Carousel Guide

Learn how to implement carousel displays