The Rating template allows you to collect quick user feedback directly from a push notification by displaying tappable rating options—using text or emojis. This layout is perfect for gauging user sentiment, collecting product feedback, or measuring satisfaction after a feature release or in-app experience. You can customize the number of rating levels (2, 3, or 5), choose between emojis or text labels, and personalize follow-up actions based on user responses.

Select Rating layout from the Content section when creating or editing any app push template.

1. Configure Content

Configure Content

Configure the following content and design elements to personalize the template's layout.

Options	Description
Title	Add a concise and attention-grabbing title for your notifications. You can apply text formatting: Bold Italics Underline Text color Background color Note: Text formatting in only supported on Android. iOS will display plain text.
Description	Provide the main message or supporting text to communicate your intent. This appears overlaid on the image. Note: Supported on both Android and iOS.
Landing Page	Set the redirection behavior when users interact with the notification: Deeplink: Opens a specific app screen. URL: Opens a browser link App Homepage: Navigates to the app’s home screen Note: These options support deep personalization and can be tracked via analytics

2. Enable APN Interactins

Enable APN Interactions

This includes all image-related and design-enhancing options that control how the push notification looks. These settings help create high-impact visuals while ensuring readability and brand consistency.

Options	Descriptions
Subtitle	Add supporting text to complement the title and description of your notification. This appears in a secondary position and helps convey additional context. Android: Displayed beside the title in both expanded and collapsed views. iOS: Displayed below the title in both states. Note: Even if subtitle is disabled for editing, a placeholder or instructional comment may appear in the preview.
Rich Media	Upload or link an image that forms the background of the notifications. Available options: Upload file: Select an image from your computer. Media URL: Use a hosted image(must start with hhtps://) Supported format: .jpg, .jpeg, .png Max size: 200 KB Note: Important content should not be placed at the bottom of the image due to cropping behavior. Only available for SDK 3.4.0 and above.
Overlay Color	Allows you to customize the color applied to the background overlay behind an app push.
Background color	Define a solid or gradient background behind the overlay image block. This is useful as a fallback or design enhancement.
Brand logo in preview	Brand logos appear automatically in previews based on platform: Android:Right side (collapsed & expanded) iOS: Left side(collapsed & expanded)
Customize collapsed state	Allows you to define how a push notification appears in its minimized form on Android devices. Marketers can upload a separate image or reuse the rich media asset with tailored layout controls when enabled. Availability Platform: Android only SDK Support: SDK v3.5.8 onwards(Android Push SDK) Dependent on: Rich media(image or carousel) being added. Suggested aspect ratio: 4:1 Available on Android only.
Enable sticky notification	Make your notifications persistent by preventing swipe dismissal. Remains in the tray until user interacts Helpful for critical updates or promotions.
Sound	Define the tone played when a notification arrives on the device. You can choose between the default device sound or a custom sound. Here are the requirements for setting a custom sound: Android Versions Below 8: Enter the sound file name in your app bundle. Supported formats are .mp3, .ogg, and .wav. Android Versions 8 and Above: Enter the name of the notification channel ID. For setup instructions, refer to the notification channel documentation . iOS: Enter the sound file name included in your app bundle. Supported formats are .aiff, .wav, and .caf. Note: The sound file name must be in your app bundle. If it is missing, the device will play the default sound.
Carousel Type	This option allows you to select between Manual and Automatic carousel transitions. In Automatic, set the timer for image transitions between 2 and 10 seconds. Note: Ensure the important part of the image is not in the lower portion. Users can add up to five images with a 2:1 aspect ratio and a maximum file size of 40KB.
Progress Bar Settings	End date & time: Select when the progress bar reaches completion. Maximum and minimum time allowed: Set the timer duration between one hour and 28 days. Message after the timer ends: Specify the message that will replace the timer text once the progress bar is completed.Local time display: Timer will automatically adjust to the user’s local time zone.

3. Rating Settings

Rating Settings

Use the Rating Configuration section to set up how users can submit feedback directly from the notification. You can customize the format, scale, and action behavior triggered by the user’s selection.

1. Choose how the rating options are displayed:

• Text/Emoji: Show short text labels (e.g., “Good”, “Okay”, “Poor”) or display graphical emojis (e.g., 😍 😐 😡) for a more visual response.
• Icon: Display custom-designed icons to represent each rating option. You can upload separate images for selected and unselected states, allowing complete control over the visual feedback and branding.

2. Define how many options you want to present:

   • 2-point scale – Ideal for binary feedback (e.g., Yes/No, Like/Dislike)
   • 3-point scale – Offers low, medium, and high sentiment options
   • 5-point scale – Enables more granular responses (e.g., full sentiment range)

3. If you have selected Icon option in the Rating setting section, then you have to configure the following:

   Option	Description
   Unselected icon	Upload the icon that represents the inactive state of a rating option, which is shown before the user taps it. 💡 Recommended: Use muted or outline versions of your icons for unselected states.
   Selected icon	Upload the icon that appears after the user taps the rating. This reflects the active or chosen state. Ensure the visual difference between selected and unselected icons is clear (e.g., color-filled vs. outline).
   CTA label	Provide a short action-oriented label that appears below or beside the icon. This helps users understand the meaning behind each rating option (e.g., “Loved it”, “Okay”, “Not for me”). Keep it concise—ideally 2–3 words.
   Deeplink	Define the deeplink that will be triggered when a user selects this icon. This can open a specific app screen based on the rating level. For example: Users who rate 4–5 stars can be redirected to a review prompt, while lower ratings could lead to a feedback form.

Rich Media

The Rich Media section allows you to enhance your push notification with visual or audio elements. These assets make your notification more engaging, improve click-through rates, and support use cases like product promotions, alerts, reminders, or limited-time offers.

Depending on your layout, you can choose from Image, Carousel, GIF, and Audio formats.

Image

When Image is selected, you’ll be prompted to add your media using one of two methods:

• Upload File: Select an image from your device
• URL: Enter the hosted image’s link (must start with https://)

📘

Points to Remembers

• Supported Formats: .jpg, .jpeg, .png
• Max Size: 200 KB
• Recommended Aspect Ratio: 2:1

Carousel

When Carousel is selected, select your layout, and you can upload multiple images (minimum 2, maximum 5):

• Upload File: Add images from your device
• URL: Provide hosted image URLs

📘

Points to Remember

• Supported Formats: .jpg, .jpeg, .png
• Max Size per Image: 40 KB
• Required Aspect Ratio: 2:1
• Transition Type: Manual or automatic (with timing between 2–10 seconds)
• Ensure each image is visually self-contained, as carousel cards don’t support per-image titles or descriptions.

Audio

When Audio is selected:

• You must provide a hosted URL to the audio file (e.g., https://example.com/alert.mp3)
• Supported Format: .mp3
• Recommended Use Case: Timers, reminders, or celebratory sounds

Note: Ensure the file is lightweight and hosted over a secure HTTPS connection.

GIF

When GIF is selected:

• Only URL upload is supported, and no local file upload option is available.
• Supported Format: .gif
• Recommended Use Case: Visual feedback, feature launches, or celebration animations

Add-on Options

Use the following enhancements to add controls and personalization to your push notification logic:

Overwrite Content with Collapse Key

Use this feature to manage notification replacement behavior in the user’s tray. Only the most recent one is displayed when multiple notifications share the same collapse key.

• Applicable for: All templates using FCM or APNS
• Use Case: Send score updates, countdowns, or stock changes without cluttering the tray.
• Example:
  1. Collapse Key: promo_alert
  2. Behavior: Only the latest “promo_alert” notification appears.

Custom Key-Value Pairs

Add up to 49 OS-specific key-value pairs to control in-app behavior when the notification is clicked. These values are passed to the app and can be used for deep personalization or routing.

• Key Example: category
• Value Example: electronics
• Use Case: When a user taps the push, the app opens the Electronics section directly.

📘

Note

• At least one platform (Android or iOS) must be selected for each key-value pair.
• These values must be handled in your app’s SDK to trigger specific actions.

Once you've configured all the content and design elements for the Overlay on Image layout, you can:

• Save Template: To use it in future campaigns
• Use in Campaign: To apply it directly to a new or existing push campaign

Your template is now ready to deliver visually compelling, high-engagement push notifications.

To learn how to create an app push campaign step-by-step, check out this document.