Breadcrumbs

RCS carousels

A carousel is a row of rich cards the customer swipes through horizontally. Each card has its own media, text and buttons. Use it for product catalogs, service packages or store locations.

At a glance

Item

Limit / notes

Number of cards

2 to 10

Card requirements

Same as a rich card

Buttons

Up to 4 per card, label max 25 characters

Card width

Small (compact, more cards visible) or medium (more visual presence). One setting for all cards.

Media height

Short, medium or tall. Can differ per card, but consistent heights usually look cleaner.

  1. Create a new RCS campaign and select message type Carousel.

  2. You start with one card. Click Add Card for each additional card.

  3. Choose card width and media height.

  4. Add media, title, description and buttons to each card.

  5. Preview, swipe through all cards, then send.

Best practices

  • Three to five cards works well.

  • Put your strongest content in the first card.

  • Keep cards consistent: similar image dimensions and text length.

  • Keep title and description to about three lines. iOS may cut off longer text.

  • Give every card a button, for example View details, Buy now or Get directions.

  • Use a 16:9 image ratio (for example 1,920 x 1,080 px). For the most consistent look on iPhone and Android, use medium width with medium media height.

More in the RCS design guidelines.

API example

JSON
"richContent": {
  "conversation": [{
    "carousel": {
      "cardWidth": "Medium",
      "cards": [{
        "header": "Card 1 title",
        "text": "Card 1 description",
        "media": { "mediaName": "img1", "mediaUri": "https://example.com/1.jpg", "mimeType": "image/jpeg" },
        "suggestions": [{ "action": "OPENURL", "label": "View details", "url": "https://www.example.com/1" }]
      }]
    }
  }]
}

Add at least one more card to the cards array (2 to 10 in total).

E-learning video

For a walkthrough in the Campaigns app, watch the e-learning video on building carousels.