Skip to main content

Documentation Index

Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt

Use this file to discover all available pages before exploring further.

RCS (Rich Communication Services) is the next evolution of text messaging. It delivers branded, app-like experiences natively in the recipient’s default messaging app — including your business name and logo as the sender identity, read receipts, carousels, action buttons, and keyword replies. RCS requires a premium RCS sender resource and a separate approval process. SMS is used as an automatic fallback when the recipient’s device or carrier does not support RCS.
Example RCS message with branded sender, image card, and action buttons

​
How RCS compares to SMS

SMSRCS
Sender identityPhone numberYour brand name, logo, and color
Read receiptsNoYes
Rich mediaMMS only (images, video)Cards and carousels with embedded media
InteractivityKeywords (inbound text)Tappable action buttons (link, keyword reply, phone number)
FallbackN/AAutomatically falls back to SMS
ApprovalStandard sender resource applicationAdditional brand assets and carrier review
PriceIncluded / standardPremium

​
Rich content types

If your sender includes an RCS sender resource, the message editor unlocks these capabilities:
  • Cards: Standalone rich messages with an image, title, description, and up to three actions.
  • Carousels: Horizontally scrollable sets of rich cards. Useful for showcasing multiple products, locations, or options in a single message.
  • Actions: Tappable buttons attached to cards. Three types are supported:
    • Link buttons: Open any http or https URL. Supports iOS Universal Links and Android App Links, which deep link into your app when it’s installed.
    • Keyword replies: Send a keyword back as the subscriber’s response without requiring them to type.
    • Phone number: Initiates a phone call directly from the message.

Composing messages

Full RCS editor reference, including image aspect ratios, action configuration, and billing categories.

​
SMS fallback

OneSignal automatically sends an SMS fallback when RCS fails to deliver — for example, when the recipient’s device or carrier doesn’t support RCS.

SMS fallback

Configure the fallback message and review the rules for text-only RCS messages.

​
Setup

RCS requires a premium RCS sender resource in addition to an SMS sender resource. The RCS sender resource must be approved separately. Approval timelines are typically 8–16 weeks. During the application process, you will need to provide additional brand assets beyond the standard sender resource application:
  • Brand logo: The image carriers display as your sender identity.
  • Brand color: The accent color used alongside your brand in the messaging app.
  • Agent description: A short paragraph carriers display alongside your brand identity, describing what subscribers should expect from your messages. “Agent” is the carrier term for the business identity that sends RCS messages.
  • Launch URL: Your business homepage or marketing page for your messaging program.
For country-specific RCS availability, approval processes, and reviewer requirements, see Sender resource applications.
In the U.S., carriers currently prioritize notable brands (Fortune 1000), high-quality rich content experiences, and established SMS sending volume (100K+ SMS messages/month through OneSignal) for RCS approval.
To get started with RCS, contact our team or reach out to your account manager.

​
Analytics

RCS messages include all standard SMS metrics plus:
  • Read: The number of subscribers who read the RCS message (available because RCS supports read receipts).

SMS message reports

Full metrics reference for delivery, click, and read events across SMS, MMS, and RCS.

​
FAQ

​
Does RCS work on all devices?

No. RCS requires the recipient’s device and carrier to support it. OneSignal automatically falls back to SMS when RCS is not supported, so every recipient gets a message regardless of device capability.

​
Can I send RCS messages internationally?

RCS availability varies by country. Not all countries where OneSignal supports SMS also support RCS. See Sender resource applications for per-country RCS availability.

​
Does an RCS sender resource replace my SMS sender resource?

No. You need both. The RCS sender resource is used when the recipient supports RCS; the SMS sender resource is used as the fallback. OneSignal handles the routing automatically within the same sender.

​
Why does the RCS editor appear for all templates when I have an RCS sender?

The Templates editor defaults to the RCS editor view whenever your account has any sender with an RCS sender resource. The template itself isn’t locked to RCS — when you send the message, pick an SMS-only sender to deliver it as SMS, or pick the RCS sender to deliver it as RCS with SMS fallback.