Send Messages using Firebase Console
You can send notification messages usingthe Notifications composerin theFirebase console. Though this does notprovide the same flexibility or scalability as sending messages with theFirebase Admin SDK or theHTTP v1 API, it can bevery useful for testing or for highly targeted marketing and user engagement.TheFirebase console provides analytics-basedA/B testing to help refine andimprove marketing messages.
After you have developed logic in your app to receive messages, you can allownon-technical users to send messages withthe Notifications composer.
About
When you send a notification message fromthe Notifications composer,FCM uses the values you enter in the form fields in these ways:
- Fields likeUser segment andExpires determine the message targetand delivery options.
- Fields likeNotification text andCustom data are sent to the clientin a payload comprised of key-value pairs.
These fields map to keys available through theMessageobject. For example, key-value pairs entered in theCustom datafield of the composer are handled as adatapayload for the notification. Other fields map directly to keys in thenotificationobject or in the platform-specificnotification configuration.
Note that some fields inthe Notifications composerarenot available through theFCM API. For example,you can target user segments based on app version, language,browser type and version, or user properties in ways that arenot available using the server API.
Caution: In another important difference from programmatic messaging,the console lets you cancel any scheduled message that is not alreadyin progress.Once a message fanout is actually in progress, it isfully committed and cannot be canceled through the console nor byFirebase support.The keys that theFirebase console sends to clients are:
| Key | Console field label | Description |
|---|---|---|
notification.title | Notification title | Indicates notification title. |
notification.body | Notification text | Indicates notification body text. |
data | Custom data | Key/value pairs that you define. These are delivered as a data payload for the app to handle. |
Keys that influence message delivery behavior include:
| Key | Console field label | Description |
|---|---|---|
sound | Sound | Indicates a sound to play when the device receives a notification. |
time_to_live | Expires | This parameter specifies how long (in seconds) the message should be kept inFCM storage if the device is offline. For more information, seeSetting the lifespan of a message. |
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-17 UTC.