User GuideDeveloper GuideAPI GuideTechnology PartnersNetcore Cloud AI: Co-Marketer
User Guide
BlogLogin

Multi-Icon

Learn to create an App push template using your Multi-icon template

Suggest Edits

The Multi-Icon template is a visually-driven app push layout that allows marketers to showcase 3 to 5 tappable icons in a single notification. Each icon can be mapped to a specific deeplink, enabling quick navigation to various in-app destinations or features without accompanying text.

This layout is designed for quick-action use cases where users can select without expanding the notification—ideal for transactional alerts, content previews, support shortcuts, or navigation menus. No text content is shown—only icons with predefined actions, making it a clean, action-first layout.

Multi-Icon Template for iOS

Multi-Icon Template for iOS

Multi-Icon Template for Android

Multi-Icon Template for Android

📘

Important Points to Remember

  • A minimum of three and a maximum of five icons must be added.
  • Each icon must have a valid deeplink. If a deeplink is broken, users will be redirected to the homepage.
  • Collapsed state behavior:
    • Android: Only icons to be shown in collapsed state. In expanded state, show layout as per user selection (Icons only or Icons with Text). Collapsed state will show title & description with first image as icon only.
    • iOS: Only first image will be shown as small icon in collapsed state. Expanded state will reflect layout selection.
  • Requires SDK v3.7.4 (Android) & v3.7.2 (iOS) or above. Devices with older SDK versions will render multi-Icon notifications as carousel notification.

When to Use

This template is ideal for:

  • Product category shortcuts (e.g., Fashion, Electronics, Grocery)
  • Quick mood polls or emoji-based surveys
  • Mini visual quizzes (e.g., “Pick your favorite”)
  • Direct navigation to popular app sections (e.g., Cart, Orders, Wallet)

Select the Multi-icon 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.

OptionsDescription
TitleAdd 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.
    DescriptionProvide the main message or supporting text to communicate your intent. This appears overlaid on the image.
    Note: Supported on both Android and iOS.
    Landing PageSet 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
    Layout When configuring the Multi-Icon template, you can choose how icons are displayed in the expanded view by selecting one of the following layout types:
  • Only icon: Displays a clean strip of icons without any text labels. Ideal for universally understood visuals(e.g., emojis, product logos, social media icons)
  • Icons with Text: Displays each icon along with a short label(max two words) in the expanded state. Helps add clarity to icons, especially when the meaning is not apparent. Useful for functional CTAs like "Cart", "Wallet", etc.

    • Note: The selected layout type will only be visible in the expanded view. Collapsed view always shows the first icon(platform-specific). This option is previewable in real time- choose the layout that best suits your content and use case.
    2. Enable APN Interactions

    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.

    OptionsDescriptions
    SubtitleAdd 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 expanded and collapsed views.
  • iOS: Displayed below the title in both states.

    • Note: Even if thesubtitle is disabled for editing, a placeholder or instructional comment may appear in the preview.
    Rich MediaUpload or link an image that forms the background of the notifications. Available options:
  • Upload file: Select an image from your computer.
  • URL: Use a hosted image(must start with https://)

    • Supported format: .jpg, .jpeg, .png
    Max size: 200 KB
    Aspect ration: 1:1
    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.
    Background colorDefine a solid or gradient background behind the overlay image block. This is useful as a fallback or design enhancement.
    Enable sticky notificationMake your notifications persistent by preventing swipe dismissal.
  • Remains in the tray until user interacts
  • Helpful for critical updates or promotions.
    • SoundDefine 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.
    3. Add-On Options

    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.

    Updated 10 days ago