Create and Send a Carousel Push Notification

Use the Carousel template to create a push notification that can have up to six images. This lets you show multiple images in one notification.

To send a Carousel notification to iOS devices, collaborate with your app developer to define the Advanced Template Category in the Administration tab. For Android, no category is required to send the Carousel notification.

Note Make sure your users are on SDK version 9.0 and later to receive carousel messages on iOS and Android devices.

1. In Content Builder, click Create, hover Mobile App, and select Push Notification.
2. Select Carousel layout, and then click Next.
3. In the Carousel Configuration panel, enter the title and body of your message.
4. Select an Open Behavior:
   • Open the App – Opens the app when the recipient taps the message.
   • Go to App URL – Opens a specific page in your app when the recipient taps the message.
   • Go to Web URL – Opens the default web browser and loads a specific URL when the recipient taps the message.
   • Go to CloudPage – Opens a CloudPage (such as a landing page or microsite) when the recipient taps the message.
   

   Note

   If you don’t provide a call to action (CTA), the SDK opens the app by default. If the CTA type is other than Open the App and the URL isn't specified or is invalid, SDK defaults to Open the App.

5. In the Image Layout section, you can show or hide the image caption and sub-caption, and add them to the Carousel pages. You can also customize the image by selecting a background color for the Carousel pages.
6. To set up a message sound on iOS devices, select an option from the dropdown menu in the iOS Configurations section.
   • Device Default: Uses the default notification sound set by the device.
   • Custom: Allows you to use a custom sound file. The default is custom.caf. For a different file, consult your app developer.
   • None: Makes the notification silent.
7. To set up your message for the Android devices, select an option from the dropdown menus in the Android Configurations section.
   • Small Icon - Appears in the top status bar and next to the app name and notification. It helps your users identify your app when they receive a push notification. The app requires the presence of a PNG file and doesn't support other formats.
   • Large Icon - Appears on the right side of the notification in the non-expanded view, giving your users additional context of the notification. Large icons support only PNG file and can be a file in the app or a URL.
   • Sound - Select the sound options from the dropdown menu, similar to those in the iOS Configuration section.
8. In the Content tab, add an image to the selected Carousel page.
   • Insert a URL or AMPscript, or select media from the Content Builder library.
     

     Tip If you use AMPscript in this field, use Subscriber Preview to verify that it renders correctly.
   • Click the plus button in the left sidebar to add more Carousel images, up to a maximum of six per notification.
   • Salesforce recommends to use images under 200KB with a 2:1 aspect ratio. Supported image formats for Android and iOS SDKs: PNG, JPEG, GIF. The GIF shows as a still image and doesn't animate.
   • Salesforce captures the image click and relay them as an ENS event. For more information, see MobilePush Event.
9. Enter a unique name or ID for the image, or use the system-generated ID. This helps differentiate it from other images in your project and is useful for tracking and automation.
10. Optionally, enter alternative text to display if the image from the URL doesn't load or is unavailable.
11. Enter the image caption, image sub-caption, and select an Open Behavior. In the Open Behavior, if no action is provided, or the URL is invalid, the SDK opens the app.
12. In the Design panel, adjust your image caption and sub-caption styles.
13. For a subscriber-level preview of your message, click Subscriber Preview.
14. Click Save.
    This push message can now be pulled into a Journey Builder push notification activity. See Create the Push Notification Activity in Journey Builder.

    

    Important Referencing other Content Builder content in blocks returns table and HTML wrappers instead of text. To reference this content, use code snippets. See ContentBlockbyID.