Design a push delivery content-push

Define the content of the notification push-message

Once your push delivery is created, you can define its content. Parameters and settings depend on the mobile operating system: Android or iOS. Browse the tabs below to learn how to compose your message for each operating system.

Android

With Firebase Cloud Messaging, you can choose between two types of messages:

  • The Data message is handled by the client app. These messages are sent directly to the mobile application, which generates and displays an Android notification on the device. Data messages contain only your custom application variables.

    To define the content, personalize data, and add dynamic content, click on the Message field and use the Expression editor. You can access this editor to customize your messages.
    In the Application variables menu, your Application variables are automatically added. These variables allow you to define notification behavior. For example, you can configure a specific application screen to be displayed when the user activates the notification.

    {modal="regular"}

  • The Notification message, handled automatically by the FCM SDK. FCM automatically displays the message on your users’ devices on behalf of the client app. Notification messages contain a predefined set of parameters and options but can still be further personalized with custom application variables.

    To compose your message, click the Title and Message fields. Use the Expression editor to define content, personalize data and add dynamic content.

    To further personalize your push notification, you can choose an image to add to your push notification, the notification’s icon to display on your profiles’ devices and its color.

    {modal="regular"}

iOS

To compose your message, click the Title and Message fields. Use the Expression editor to define content, personalize data and add dynamic content.

You can add a Subtitle, value of the subtitle parameter of the iOS notification payload. Refer to the this section.

The Silent Push mode allows a “silent” notification to be sent to a mobile application. The user is not made aware of the notification’s arrival. It is transferred directly to the application.

{modal="regular"}

Push notification advanced settings push-advanced

Advanced options depend on the mobile operating system: Android or iOS. Browse the tabs below to learn how to define options for your message for each operating system.

Android

{modal="regular"}

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2
Parameter Description
Sound Set the sound to play when the device receives your notification.
Notification Count Set the number of new unread information to be displayed directly on the application icon. This allows the user to quickly see the number of pending notifications.
Channel ID Set your notification’s channel ID. The app must create a channel with this channel ID before any notification with this channel ID is received.
Click action Define the action associated with a user click on your notification. This determines the behavior when the user interacts with the notification, such as opening a specific screen or performing a specific action in your app.
Tag Set an identifier used to replace existing notifications in the notification drawer. This helps prevent the accumulation of multiple notifications and ensures that only the latest relevant notification is displayed.
Priority Set the priority level of your notification, which can be default, minimum, low, or high. The priority level determines the importance and urgency of the notification, influencing how it is displayed and whether it can bypass certain system settings. For more on this, refer to FCM documentation.
Visibility Set the visibility level of your notification, which can be public, private, or secret. The visibility level determines how much of the notification’s content is shown on the lock screen and other sensitive areas. For more information, refer to the FCM documentation.
Sticky When activated, the notification remains visible even after the user clicks on it.
If deactivated, the notification is automatically dismissed when the user interacts with it. The sticky behavior allows important notifications to persist on the screen for longer periods.
Application variables Allow you to define notification behavior. These variables are fully customizable and are included as part of the message payload sent to the mobile device.
iOS

{modal="regular"}

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2
Parameter Description
Critical alert mode Enable this option to add sound to your notification, even when the user’s phone is set to focus mode or if the device is muted. This ensures that important alerts are noticed by the user. When selected, you can adjust the volume of the notification using the Volume level bar. A number between 0 and 100 above the bar reflects your settings.
Clean Badge Enable this option to refresh the badge value displayed on the application icon. It ensures that the badge accurately reflects the number of new unread information.
Notification count Set a number that will be displayed directly on the application icon, indicating the number of new unread information. This provides a quick visual reference for the user.
Volume Volume of your sound from 0 to 100.
Mutable content Enable this option to allow the mobile application to download media content associated with the notification. For more on this, refer to Apple developer documentation.
Relevance score Set a relevance score from 0 to 100 to prioritize the order of notifications in the notification summary. Higher scores indicate more important notifications.
Interruption level
  • Active: Set by default, the system presents the notification immediately, lights up the screen, and can play a sound. Notifications do not break through Focus modes.
  • Passive: The system adds the notification to the notification list without lighting up the screen or playing a sound. Notifications do not break through Focus modes.
  • Time sensitive: The system presents the notification immediately, lights up the screen, can play a sound and break through Focus modes. This level does not require a special permission from Apple.
  • Critical: The system presents the notification immediately, lights up the screen, and bypasses the mute switch or focus modes. Note that this level requires a special permission from Apple.
Thread-id Identifier used to group related notifications together. Notifications with the same thread ID are organized as a single conversation or thread in the notification list.
Category Specify the name of the category ID associated with the notification. This enables the display of action buttons, allowing the user to perform various tasks directly from the notification without opening the application.
Target content ID Identifier used to target which application window to brought forward when the notification is opened.
Launch image Specify the name of the launch image file to be displayed when the user chooses to launch your application from the notification. The selected image will be shown instead of your application’s regular launch screen.
Application variables Allow you to define notification behavior. These variables are fully customizable and are included as part of the message payload sent to the mobile device.
recommendation-more-help
c39c2d00-ba9a-424b-adf9-66af58a0c34b