Setting the Icon, Image, and Badge

You can add the default web icon in the Web Push Setup configuration.

The images can be set when:

• Sending Push Messages from the dashboard.
• Sending from API, use chrome_web_icon, chrome_web_image, and chrome_web_badge parameters

Icon Requirements

All browsers support icons.
Safari will only use the default icon.

Image Requirements

Custom large images only supported on Windows and Android. macOS doesn't support large images since Chrome 59 and only expands the large icon. See Chrome Developer Docs imageUrl for details. macOS expands the chrome_web_icon.

🚧

Media Upload Limitations

OneSignal only stores images uploaded to our servers for 33 days from the time it was uploaded.

If you duplicate or use a draft message with an image uploaded longer than 33 days, you will need to re-upload the image.

If you need the image for longer, you can use templates or store the image on your own servers and reference the resource URL directly.

📘

Image Issues?

For troubleshooting, see Notification Images Not Showing.

Badge

Chrome on Android

For Chrome 53+ on Android 6.0+, the badge replaces the Chrome browser icon that appears on the notification tray and above the title. In this example, a custom badge for the app replaces the Chrome browser icon:

Badge Requirements

Here's an example badge icon of our OneSignal logo that uses only the alpha channel.