iOS Push Icon

By default, iOS uses the app icon for push notifications, but you can personalize the notifications with custom icons to better align with your branding and messaging. Follow the steps outlined below to set up and send push notifications with custom icons, and learn how to manage default and custom icon configurations.

Requirements

1. Minimum SDK Version: The application must be running on SDK Version 3.19.0 or later.

2. Media Push Integration: Media push integration must also be implemented. Please see our documentation on Media Push.

Default Push Icon Behavior

When creating a new campaign, if the Custom Push Icon option is turned off in the "What" step:

• The system checks the icon name specified in Developer > App Info > iOS Push Style > Default Notification Icon.

• If an icon name is provided in this field, push notifications will be sent using that default icon.

iOS Push Notifications with Custom Icons

In iOS, push notifications are displayed with your app icon by default. If you update your app icon via Xcode > Assets > App Icon, the push notification icon will automatically reflect this update.

Using Custom Icons for Push Notifications

To send push notifications with a custom icon instead of the default app icon, follow these steps:

• App Icon: Appears as a small icon (Netmera Icon) in the bottom-right corner of the notification.

• Custom Icon: Serves as the primary, larger icon (Impact Icon) in the notification.

This feature enables personalized notifications while maintaining brand recognition with the app icon.

Step 1. Update iOS SDK Version

Ensure that the iOS SDK is updated to the latest release to access new features and maintain compatibility.

Step 2. Add Communication Notification Capability

Integrate the Communication Notification capability into your project to enable custom push functionality.

Step 3. Configure Info.plist

Add NSUserActivityTypes with InSendMessageIntent as item 0 to the Info.plist of the main project.

Step 4. Include Visuals in Service Extension

Add your custom icon image to the Service Extension section of your project to ensure proper usage and display.

Step 5. Push Icon Configuration

Specify the custom push icon file name by navigating to: Netmera Panel > Developer > App Info > iOS Push Style, and enter the file name in the Default Notification Icon field.

Entering Icon Name:

When you enter your custom icon, make sure to include the full name of the file along with its extension, such as icon.png.

Creating a Push with Custom Push Icon

When configuring a push notification:

• In the What step, use the Custom Push Icon option to select your desired custom icon.

When Custom Push Icon Is Turned Off:

If the Custom Push Icon option is disabled, the system will use the default notification icon specified in Developer > App Info > iOS Push Style (if provided).