{"id":6156,"date":"2026-01-05T14:40:45","date_gmt":"2026-01-05T13:40:45","guid":{"rendered":"https:\/\/www.smsapi.com\/blog\/?p=6156"},"modified":"2026-01-15T12:21:22","modified_gmt":"2026-01-15T11:21:22","slug":"rcs-specification","status":"publish","type":"post","link":"https:\/\/www.smsapi.com\/blog\/rcs-specification\/","title":{"rendered":"RCS Technical Service Specification"},"content":{"rendered":"\n

RCS Specification \u2013 learn the requirements and technical details related to RCS messaging.<\/strong><\/p>\n\n\n\n\n\n\n\n

RCS Technical Specification (Documentation)<\/h2>\n\n\n\n

The new communication standard RCS (Rich Communication Services) is currently being implemented. Below you will find the RCS technical specification. Also, check the official Google Documentation<\/a>.<\/p>\n\n\n\n

RCS Brand Agent<\/h2>\n\n\n\n

The *<\/strong><\/mark><\/strong> symbol indicates elements required in the RCS documentation.<\/p>\n\n\n\n

Element<\/strong><\/td>Requirements<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
Name*<\/strong><\/mark><\/strong><\/strong><\/td>up to 40 characters with spaces<\/td>display name that will appear in the conversation header and inbox<\/td><\/tr>
Description*<\/strong><\/mark><\/strong><\/strong><\/td>up to 100 characters with spaces<\/td>\u2013 additional description, space for a slogan or claim \u2013 displayed on the brand agent profile and at the start of the conversation<\/td><\/tr>
Color<\/strong><\/td>HEX format<\/td>\u2013 color of the brand agent’s fixed elements \u2013 if no color is specified, a default color will be selected<\/td><\/tr>
Banner*<\/strong><\/mark><\/strong><\/strong><\/td>\u2013 allowed formats: JPEG, JPG, PNG \u2013 dimensions: 1440\u00d7448 px<\/td>wide graphic that will be displayed on the brand agent profile<\/td><\/tr>
Logo*<\/strong><\/mark><\/strong><\/strong><\/td>\u2013 allowed formats: JPEG, JPG, PNG \u2013 dimensions: 224\u00d7224 px<\/td>\u2013 graphic that appears in the inbox and in the conversation window header; \u2013 the logo is cropped to a circle, so do not place important elements in the corners<\/td><\/tr>
Phone number*<\/strong><\/mark><\/strong><\/strong><\/td>phone number<\/td>fixed brand agent element with a handset icon<\/td><\/tr>
Website*<\/strong><\/td>URL address<\/td>fixed brand agent element with a globe icon<\/td><\/tr>
Email*<\/strong><\/td>email address<\/td>fixed brand agent element with an envelope icon<\/td><\/tr>
Contact<\/strong><\/td>up to three elements from each group<\/td>additional information that directs customers to the website or phone\/email contact<\/td><\/tr>
Contact: Phone<\/strong><\/td>\u2013 phone number \u2013 label<\/td>label, e.g., Customer Service<\/td><\/tr>
Contact: Website<\/strong><\/td>\u2013 URL address \u2013 label<\/td>label, e.g., Homepage<\/td><\/tr>
Contact: Email<\/strong><\/td>\u2013 email address \u2013 label<\/td>label, e.g., Write to us<\/td><\/tr>
Privacy Policy<\/strong><\/td>URL address<\/td>link to your company’s privacy policy in the Options section<\/td><\/tr>
Terms of Service<\/strong><\/td>URL address<\/td>link to your terms of service in the Options section<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

RCS Basic<\/h2>\n\n\n\n
Element<\/strong><\/td>Requirements<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
Brand agent<\/strong><\/td>see RCS Brand Agent table<\/td>each message will be provided with a verified brand agent<\/td><\/tr>
Content<\/strong><\/td>up to 160 characters with spaces<\/td>content of the RCS Basic message; you can use emojis and special characters<\/td><\/tr>
Interactions<\/strong><\/td>none<\/td>suggested actions cannot be added; use other RCS types to include them<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

RCS Single<\/h2>\n\n\n\n
Element<\/strong><\/td>Requirements<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
Brand agent<\/strong><\/td>see RCS Brand Agent table<\/td>each message will be provided with a verified brand agent<\/td><\/tr>
Content<\/strong><\/td>\u2013 up to 3072 characters with spaces OR \u2013 media file (see below)<\/td>content of the RCS Single message; you can use emojis and special characters or add one media file<\/td><\/tr>
Media file: Graphic<\/strong><\/td>\u2013 formats: JPEG, JPG, GIF, PNG \u2013 size up to 100 MB<\/td>\u2013 graphic, photo, chart, infographic, QR code \u2013 recommended size: below 10 MB<\/td><\/tr>
Media file: Video<\/strong><\/td>\u2013 formats: H263, M4V, MP4, MPEG4, MPEG, WEBM \u2013 size up to 100 MB<\/td>\u2013 movie, animation, video presentation \u2013 recommended size: below 10 MB<\/td><\/tr>
Media file: Audio<\/strong><\/td>\u2013 formats: AAC, MP3, MPEG, MPG, MP4, MP4-LATM, 3GPP, OGG \u2013 size up to 100 MB<\/td>\u2013 sound, voice, recording, music, podcast \u2013 recommended size: below 10 MB<\/td><\/tr>
Media file: Document<\/strong><\/td>\u2013 format: PDF \u2013 size up to 100 MB<\/td>\u2013 ebook, instruction, manual, presentation \u2013 recommended size: below 10 MB<\/td><\/tr>
Interactions in message<\/strong><\/td>\u2013 up to 11 suggested actions or replies below the message \u2013 each: up to 25 characters with spaces<\/td>see RCS Interactions<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

RCS Rich Card<\/h2>\n\n\n\n
Element<\/strong><\/td>Requirements<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
Brand agent<\/strong><\/td>see RCS Brand Agent table<\/td>each message will be provided with a verified brand agent<\/td><\/tr>
Title<\/strong><\/td>up to 200 characters with spaces<\/td>card header; you can use emojis and special characters<\/td><\/tr>
Content<\/strong><\/td>up to 2000 characters with spaces<\/td>card content; you can use emojis and special characters<\/td><\/tr>
Media file<\/strong><\/td>\u2013 graphic OR \u2013 video<\/td>specify the type of file to be placed on the card<\/td><\/tr>
Media file: Graphic<\/strong><\/td>\u2013 formats: JPEG, JPG, GIF, PNG \u2013 size up to 100 MB<\/td>\u2013 graphic, photo, chart, infographic, QR code

\u2013 recommended size: below 10 MB<\/td><\/tr>
Media file: Video<\/strong><\/td>\u2013 formats: H263, M4V, MP4, MPEG4, MPEG, WEMB \u2013 size up to 100 MB<\/td>\u2013 movie, animation, video presentation \u2013 recommended size: below 10 MB<\/td><\/tr>
Card orientation<\/strong><\/td>\u2013 horizontal (requires: file + title\/content\/interaction)
OR \u2013 vertical (any combination possible)<\/td>		choose layout: \u2013 horizontal: elements arranged left to right \u2013 vertical: elements arranged top to bottom<\/td><\/tr>
Horizontal: File position<\/strong><\/td>\u2013 left OR \u2013 right<\/td>display location of the media file<\/td><\/tr>
Horizontal: Media<\/strong><\/td>recommended width: 128 px<\/td>height adjusts to text elements<\/td><\/tr>
Vertical: Media<\/strong><\/td>rec. heights: short (122px), medium (168px), tall (264px)<\/td>width adjusts to the screen<\/td><\/tr>
Interactions on card<\/strong><\/td>up to 4 suggested actions or replies pinned to the card<\/td>see RCS Interactions<\/a><\/td><\/tr>
Interactions in message<\/strong><\/td>up to 11 suggested actions or replies below the message<\/td>see RCS Interactions<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Recommended media widths and heights are in pixels; check Google Documentation<\/a>.<\/em><\/p>\n\n\n\n

RCS Carousel<\/h2>\n\n\n\n
Element<\/strong><\/td>Requirements<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
Brand agent<\/strong><\/td>see RCS Brand Agent table<\/td>each message will be provided with a verified brand agent<\/td><\/tr>
Cards<\/strong><\/td>from 2 to 10 Rich Cards<\/td>an RCS carousel can consist of up to 10 Rich Cards<\/td><\/tr>
Card width<\/strong><\/td>\u2013 small carousel: max 180 px OR \u2013 medium carousel: max 296 px<\/td>choose one option<\/td><\/tr>
Card height<\/strong><\/td>\u2013 small carousel: max 542 px OR \u2013 medium carousel: max 592 px<\/td>card height scales to the tallest card<\/td><\/tr>
Title<\/strong><\/td>up to 200 characters with spaces<\/td>card header; you can use emojis and special characters<\/td><\/tr>
Content<\/strong><\/td>text cropped to carousel height<\/td>card content; you can use emojis and special characters<\/td><\/tr>
Interactions on card<\/strong><\/td>up to 4 suggested actions or replies per card<\/td>each card can have different interactions<\/td><\/tr>
Interactions in message<\/strong><\/td>up to 11 suggested actions or replies below the carousel<\/td>see RCS Interactions<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Recommended media widths and heights are in pixels; check Google Documentation<\/a>.<\/em><\/p>\n\n\n\n

RCS Interactions<\/h2>\n\n\n\n

Interactions (Suggested Actions and Suggested Replies) can be added to any RCS type except RCS Basic.<\/p>\n\n\n\n

Element<\/strong><\/td>Requirements<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
Interactions on card<\/strong><\/td>up to 4 actions\/replies<\/td>displayed within the Rich Card or Carousel card<\/td><\/tr>
Interactions in message<\/strong><\/td>up to 11 actions\/replies<\/td>displayed below the last message<\/td><\/tr>
Suggested actions<\/strong><\/td>up to 25 characters with spaces<\/td>\u2013 personalized content \u2013 icons matched to the action<\/td><\/tr>
Action: Dial number<\/strong><\/td>\u2013 phone number \u2013 label<\/td>redirects to the default dialer with the number pre-filled<\/td><\/tr>
Action: View location<\/strong><\/td>\u2013 coordinates or pin \u2013 label<\/td>redirects to the default maps app at the specified location<\/td><\/tr>
Action: Share location<\/strong><\/td>\u2013 user-provided location \u2013 label<\/td>sends the user’s location (does not have to be real)<\/td><\/tr>
Action: Open URL<\/strong><\/td>\u2013 URL address \u2013 label<\/td>\u2013 opens the address in the browser or associated app \u2013 deep links will have matched icons<\/td><\/tr>
Action: Create calendar event<\/strong><\/td>\u2013 event information \u2013 label<\/td>redirects to the default calendar app to create a new event<\/td><\/tr>
Action: Send message<\/strong><\/td>\u2013 phone number \u2013 label<\/td>redirects to the default messaging app to a specified number<\/td><\/tr>
Suggested replies<\/strong><\/td>up to 25 characters with spaces<\/td>\u2013 automatic information exchange within a scenario \u2013 no icons, but supports emojis<\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"excerpt":{"rendered":"

RCS Specification \u2013 learn the requirements and technical details related to RCS messaging.<\/p>\n","protected":false},"author":21,"featured_media":6162,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[160,55],"class_list":["post-6156","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-knowledge","tag-160","tag-rcs"],"_links":{"self":[{"href":"https:\/\/www.smsapi.com\/blog\/wp-json\/wp\/v2\/posts\/6156","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.smsapi.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.smsapi.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.smsapi.com\/blog\/wp-json\/wp\/v2\/users\/21"}],"replies":[{"embeddable":true,"href":"https:\/\/www.smsapi.com\/blog\/wp-json\/wp\/v2\/comments?post=6156"}],"version-history":[{"count":2,"href":"https:\/\/www.smsapi.com\/blog\/wp-json\/wp\/v2\/posts\/6156\/revisions"}],"predecessor-version":[{"id":6160,"href":"https:\/\/www.smsapi.com\/blog\/wp-json\/wp\/v2\/posts\/6156\/revisions\/6160"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.smsapi.com\/blog\/wp-json\/wp\/v2\/media\/6162"}],"wp:attachment":[{"href":"https:\/\/www.smsapi.com\/blog\/wp-json\/wp\/v2\/media?parent=6156"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.smsapi.com\/blog\/wp-json\/wp\/v2\/categories?post=6156"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.smsapi.com\/blog\/wp-json\/wp\/v2\/tags?post=6156"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}