RCS design guidelines

iPhone and Android display RCS messages slightly differently. These guidelines help your message look good on both.

Images

Message type

Recommended aspect ratio

Example size

Rich card

3:2

1,620 x 1,080 px

Carousel

16:9

1,920 x 1,080 px

  • Keep important content about 5% away from each edge (safe zone).

  • For horizontal cards, keep key content in a centered square (1:1) area, for example 972 x 972 px on a 1,080 x 1,920 px image. iPhone shows the image at 60 x 60 DP, and on Android longer text crops the image more.

  • Supported image formats: JPEG, PNG and GIF. GIFs are not animated on iPhone. SVG is not supported.

  • Media that does not fit the chosen height is zoomed and cropped. Portrait images stay portrait on iPhone, while Android crops them to the center.

  • With default text size in portrait mode, images are not cropped. Cropping can still happen in landscape mode or with a larger text size.

Media height

Setting

Height

Effect

Short

112 DP

Compact, text takes center stage

Medium

168 DP

Balanced

Tall

264 DP

The image is the star

Use Tall for a rich card and Medium for a carousel. This gives the most consistent result on iPhone and Android. A standalone card is between 112 and 344 DP high and grows with its content. Carousel cards can be taller (up to 542 DP for small and 592 DP for medium width), and all cards scale to the tallest.

Text

  • Rich card title: up to 200 characters. Description: up to 2,000 characters.

  • In a carousel, keep title and description to about three lines. iOS may cut off longer text.

  • Make titles punchy. Put key details in the description.

Buttons

  • Label: maximum 25 characters. Short and clear works best.

  • Maximum 4 buttons per card. For the most consistent display, use one action (such as open URL or call) and up to three replies.

  • Put the main action first. iPhone always places actions above replies.

  • On iPhone, more than two actions collapse into an Options menu.

  • Do not combine buttons inside a card with suggestion chips below it in the same message. iPhone and Android show them differently.

Carousels

  • Three to five cards works best.

  • Put the strongest content in the first card.

  • Keep cards consistent in image dimensions and text length. iPhone adjusts card size to image and text, while Android crops to equal sizes, so inconsistent cards look different per platform.

  • For the most consistent look on iPhone and Android, use medium width with medium media height.

Always preview

Check the phone preview in the Campaigns app before you send. For a carousel, swipe through all cards.