# Push Icon

By default, iOS displays the app icon in push notifications. However, you can personalize the notifications with custom icons to better align with your branding and messaging. Below are the steps to set up and manage custom push icons.

{% hint style="warning" %}

#### Requirements

* **Minimum SDK Version**: Your application must be running SDK Version 3.19.0 or later.
* **Media Push Integration**: Media push integration must also be implemented. Please see our documentation for more details on [media-push](https://user.netmera.com/netmera-developer-guide/platforms/ios/former-ios-objective-c/push-notifications/media-push "mention").
  {% endhint %}

### Default Push Icon

When creating a new campaign, if the "Custom Push Icon" option is turned off or not configured.

* 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 use the 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.

<figure><img src="https://2578508252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0bOAscrXzPSujyzq8DEz%2Fuploads%2FVwVihToUCGBry6h8f9au%2FScreenshot%202024-11-26%20at%2010.56.41.png?alt=media&#x26;token=01ca9713-be16-4edb-a95a-bad8fa8e8f8f" alt="" width="563"><figcaption></figcaption></figure>

### Step 1: Update iOS SDK Version

Ensure that your iOS SDK is updated to the latest version (SDK 3.19.0 or later) to access new features and maintain compatibility.

### Step 2: Add Communication Notification Capability

Integrate the **Communication Notification** capability into your project. This enables the custom push functionality for your app.

<figure><img src="https://2578508252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0bOAscrXzPSujyzq8DEz%2Fuploads%2FwGwdPswaNyAbd3Ye7svU%2FScreenshot%202023-11-14%20at%2014.56.11.png?alt=media&#x26;token=a0b213a4-e4a3-4c9c-b861-b1e433226d5c" alt="" width="563"><figcaption></figcaption></figure>

### Step 3: Configure `Info.plist`

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

<figure><img src="https://2578508252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0bOAscrXzPSujyzq8DEz%2Fuploads%2FE0JoIwYybHNQebufoYUX%2Fimage.png?alt=media&#x26;token=9d273498-b007-448f-aed6-b48cb376e439" alt=""><figcaption></figcaption></figure>

### Step 4: Include Visuals in Service Extension

Add your custom icon image to the **Service Extension** section of your project to ensure that the icon is used and displayed properly in the notification.

<figure><img src="https://2578508252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0bOAscrXzPSujyzq8DEz%2Fuploads%2F4cxJWtHNyQgNvZTqZFzb%2FScreenshot%202023-11-14%20at%2015.03.47.png?alt=media&#x26;token=2e0b17f6-bbcc-474f-97b8-e733954e264d" alt="" width="449"><figcaption></figcaption></figure>

### Step 5: Push Icon Configuration

1. Navigate to **Netmera Panel > Developer > App Info > iOS Push Style** and enter the name of your custom push icon in the **Default Notification Icon** field.
2. When entering the custom icon file name, include the full file name along with its extension (e.g., `icon.png`).

<figure><img src="https://2578508252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0bOAscrXzPSujyzq8DEz%2Fuploads%2FCAWjJFH17AUSJt0leV9S%2Fimage.png?alt=media&#x26;token=dcde7edd-6cf5-4399-a2f6-a9eb8ee52aae" alt=""><figcaption></figcaption></figure>

### Creating a Push with Custom Push Icon

1. **In the "What" Step** of the campaign setup, enable the **Custom Push Icon** option.
2. **Select Custom Icon**: Choose your desired custom icon.

{% hint style="info" %}

#### **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).
{% endhint %}

<figure><img src="https://2578508252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0bOAscrXzPSujyzq8DEz%2Fuploads%2FTkuuOpW0rya2eHudnsef%2FUntitled%20(1).png?alt=media&#x26;token=1b951560-8618-4c37-9479-c001d76ea1ea" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://2578508252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0bOAscrXzPSujyzq8DEz%2Fuploads%2FeWrJZ3C7CqtDdOvzdlnG%2FUntitled%20(2).png?alt=media&#x26;token=67d310d8-689e-46b8-88df-79cfea264149" alt="" width="563"><figcaption></figcaption></figure>