
Ejemplo de una notificación de Web Push de Android Chrome con icono de insignia pequeño, icono grande e imagen.
Iconos de notificación de Android
Android (incluidos los dispositivos Amazon y Huawei) admite iconos de notificación pequeños y grandes. En Android 8.0+ (API 26+), las categorías de notificación y la UI del fabricante también afectan cómo se ve la notificación. Android también admite Notificaciones de conversación que pueden mostrar la imagen de perfil de una persona en lugar de su icono.
Iconos de notificación pequeños
El icono de notificación pequeño es obligatorio. Aparece en la barra de estado como una silueta monocromática. Si no proporciona un icono pequeño personalizado, OneSignal usa un icono de campana predeterminado. La ubicación del icono en la notificación cambia en Android 17 (API 37). Consulte Icono de inicio en la notificación. Android renderiza los iconos de notificación pequeños usando el canal alfa del icono, no sus datos de color. A partir de Android 12 (API 31), el sistema tiñe esa silueta con el color de acento de notificación que usted configure. Si no configura un color, usa el color del tema del sistema. Consulte Diseño de notificaciones de Android. Requisitos:- Use un icono de silueta monocromático sobre un fondo transparente
- Diseñe el icono para que la forma esté definida por la transparencia, no por el color
- Evite degradados, sombras o ilustraciones multicolores
- Mantenga el diseño simple y reconocible en tamaños muy pequeños
Icono de inicio en la notificación (Android 17)
A partir de Android 17 (API 37), Android muestra el icono de inicio de su aplicación en la notificación en lugar del icono pequeño. El icono pequeño sigue apareciendo en la barra de estado. Este es un comportamiento del sistema Android que se aplica a todas las notificaciones, y la apariencia exacta puede variar según el fabricante del dispositivo. Para mostrar el icono pequeño en la notificación en su lugar, configure el extraEXTRA_PREFER_SMALL_ICON de Android. El SDK de OneSignal no configura este extra de forma predeterminada. Agréguelo en su extensión de servicio de notificaciones. Anote la clase con @Keep y regístrela en el manifiesto como se muestra en esa página.
compileSdk. Android 16 (API 36) y versiones anteriores ignoran el extra, por lo que es seguro configurarlo incondicionalmente.
Color de acento del icono pequeño
Puede configurar el color de acento de la notificación que Android 12 (API 31) y versiones más recientes usan para teñir el icono pequeño. Esto corresponde alNotification.color (setColor) de Android. No es lo mismo que colorear el fondo de la notificación (setColorized), que Android reserva para tareas en curso de alta prioridad.
El color de acento es una propiedad por notificación, no una propiedad del canal. Las categorías de notificación de Android controlan el sonido, la importancia, la vibración, el color del LED y las insignias. Las categorías no tienen configuración de color de acento, y su color de acento se aplica independientemente de la categoría en la que se muestre la notificación.

- Por mensaje: el parámetro
android_accent_color(Google Android) ohuawei_accent_color(Huawei) en la API Crear mensaje, o el campo Accent color en Messages > Push > New Push > Platform Settings > Google Android Options. - Predeterminado de la aplicación mediante recursos: el recurso de cadena
onesignal_notification_accent_color. - Predeterminado de la aplicación mediante el manifiesto: la entrada meta-data
com.onesignal.NotificationAccentColor.DEFAULTenAndroidManifest.xml.
# (por ejemplo, FF00FF00). Puede previsualizar colores en Android Asset Studio.
Para establecer un color predeterminado con recursos, agregue la siguiente línea a su archivo res/values/strings.xml. Para un color diferente en modo oscuro, agregue la misma clave a res/values-night/strings.xml.
<application>:
notification.setExtender con builder.setColor(). El extender se ejecuta después de que el SDK aplica los valores anteriores, por lo que los anula todos.
Iconos de notificación grandes
El icono grande es opcional. Aparece en el lado derecho de la notificación. La guía de diseño de Android es usarlo solo cuando la imagen refuerza el contenido de la notificación, como la foto de un remitente, el logotipo de una fuente de terceros o un símbolo significativo. No use el icono grande como un segundo icono de aplicación ni para branding. Consulte The large icon.- Tamaño recomendado: 256×256 píxeles
- Formato: PNG o JPG
- Se permite el color. No se requiere solo alfa.
Cómo agregar iconos predeterminados de Android
Configure iconos predeterminados para cada aplicación basada en Android (Google Play, Amazon, Huawei). Finalice primero la Configuración del SDK de Android (o su configuración multiplataforma). Agregue los archivos a los directorios de recursos de su proyecto (o a una configuración de plugin para Expo), recompile y publique. Los archivos faltantes o con nombres incorrectos son la causa más común de renderización defectuosa. Los iconos predeterminados se incluyen en el binario de la aplicación. No se cargan en el panel de OneSignal. Después de publicar, espere hasta que la mayoría de los usuarios actualicen antes de enviar notificaciones que dependan de un nuevo nombre de icono.Generar el icono de notificación pequeño
ic_stat_onesignal_defaultCrear los tamaños de icono pequeño requeridos
Generar el icono de notificación grande (opcional)
ic_onesignal_large_icon_default.pngColocar los iconos en las rutas de proyecto correctas
drawable-xxxhdpi/ junto al icono pequeño XXXHDPI. Los dos archivos comparten una carpeta y usan nombres diferentes.- Android Native
- Unity
- React Native / Expo
- Flutter
- Cordova
- Capacitor
- .NET MAUI
ic_stat_onesignal_default):res/drawable-mdpi/(24×24)res/drawable-hdpi/(36×36)res/drawable-xhdpi/(48×48)res/drawable-xxhdpi/(72×72)res/drawable-xxxhdpi/(96×96)
ic_onesignal_large_icon_default.png, 256×256):res/drawable-xxxhdpi/

Proyecto Android Native con archivos de icono en las carpetas drawable
Iconos de notificación de iOS
Las notificaciones de iOS siempre usan el icono de su aplicación. El sistema muestra una versión grande de ese icono en el borde inicial de cada notificación y lo escala desde el recurso de icono de su aplicación. No puede cambiarlo por mensaje. Para cambiarlo, actualice el icono de la aplicación y publique una nueva versión de la aplicación. Consulte Human Interface Guidelines: Notifications.alert, badge y sound. No tiene ningún campo para un icono de notificación personalizado. Apple ignora las claves personalizadas dentro del diccionario aps. Esto se aplica a las notificaciones push estándar y a las Alertas críticas. La UI de Live Activity puede mostrar sus propias imágenes a través de ActivityKit. Eso no es un reemplazo del icono de notificación.Notificaciones de comunicación
En iOS 15 y versiones más recientes, Apple admite Notificaciones de comunicación para aplicaciones de mensajería y llamadas. Después de donar unINSendMessageIntent o INStartCallIntent, el sistema puede mostrar el avatar del remitente o de quien llama (INImage) en lugar del icono grande de la aplicación. El icono de la aplicación sigue apareciendo como una pequeña insignia sobre ese avatar.
Esto requiere la capacidad de Communication Notifications, intents de SiriKit y una Notification Service Extension para actualizar el contenido de la notificación. No está disponible para notificaciones de propósito general.
Iconos de notificación web
Las notificaciones push web muestran un icono proporcionado en el momento del envío o configurado como predeterminado en la configuración de su sitio. Si no se proporciona ningún icono, se usa un icono de campana predeterminado.- Formatos compatibles: PNG, JPG, GIF (no animado)
- El icono debe ser cuadrado. El tamaño recomendado es
256×256píxeles. web.dev cita 64dp en Android, por lo que192×192o más grande es el mínimo habitual.256×256sigue siendo el tamaño más consistente entre Chrome, Firefox, Edge y Safari. - Los navegadores y sistemas operativos recortan y escalan el icono de manera diferente. Chrome y Firefox usan la UI de notificaciones de la plataforma donde existe una.
Icono de insignia de web push de Android
En Android, el web push de Chrome puede mostrar un icono de insignia más pequeño en la barra de estado cuando no hay suficiente espacio para la notificación completa. OneSignal lo envía conchrome_web_badge, que corresponde a la opción badge de la Notifications API. Chrome en Android usa esta insignia. Si no configura una, Chrome usa el icono del navegador. Otros navegadores generalmente muestran el icono del navegador. Consulte Notification: badge.
Esta no es una insignia de icono de aplicación (punto o número). Para esas, consulte Insignias.
Trate la insignia como un icono monocromático. MDN indica que Android enmascara automáticamente la imagen. Use una silueta PNG cuadrada sobre un fondo transparente (las mismas reglas que el icono pequeño de Android). Evite texto, detalles finos e ilustraciones de color completo.
MDN recomienda alrededor de 96×96 píxeles para que la imagen se mantenga bien a 4x. 72×72 es el mínimo habitual (24dp a 3x). Las imágenes más grandes se reducen.

Ejemplo de cómo se muestra el icono de insignia en la barra de estado de Android.
Enviar notificaciones con iconos no predeterminados
Cuando envía push desde el panel de OneSignal o la API REST, puede anular los iconos predeterminados para Android, Amazon, Huawei y Web Push. No puede anular el icono para notificaciones de iOS.Parámetros de la API REST
Android, Amazon y Huawei:adm_small_icon. Para Huawei use huawei_small_icon.Ejemplo: "small_icon": "my_custom_icon"adm_large_icon. Para Huawei use huawei_large_icon.Ejemplo: "large_icon": "my_custom_icon"firefox_icon.Ejemplo: "chrome_web_icon": "https://example.com/my_custom_icon.png""chrome_web_badge": "https://example.com/badge.png"Panel de control
En Messages > Push > New Push o Templates, abra las opciones específicas de la plataforma. Para Android, Amazon y Huawei, si el archivo existe en la misma ruta de proyecto que el icono predeterminado, establezca los nombres de los iconos sin la extensión del archivo. Para los iconos de notificación grandes, también puede proporcionar una URL directa.
Panel de OneSignal, donde anular los iconos predeterminados.
Preguntas frecuentes
¿Por qué mi icono pequeño de Android aparece como un cuadrado blanco o gris?
La imagen no tiene la transparencia adecuada. Android renderiza los iconos de notificación pequeños usando únicamente el canal alfa. Los píxeles completamente opacos con un fondo sólido aparecen como un cuadrado relleno. Regenere el icono como una silueta monocromática sobre un fondo transparente usando Android Asset Studio.¿Por qué aparece el icono de campana de OneSignal en lugar de mi icono personalizado?
Una o más variantes de densidad requeridas del icono pequeño faltan, están ubicadas en el directorio drawable incorrecto o tienen un nombre incorrecto. Incluya los cinco tamaños (MDPI a XXXHDPI) con el nombre de archivo exactoic_stat_onesignal_default. Consulte Cómo agregar iconos predeterminados de Android para las rutas correctas.
¿Por qué las notificaciones muestran el icono de mi aplicación en lugar de mi icono pequeño?
A partir de Android 17 (API 37), Android muestra el icono de inicio de la aplicación en la notificación de forma predeterminada. El icono pequeño sigue apareciendo en la barra de estado. Para mostrar el icono pequeño en la notificación, configure el extraEXTRA_PREFER_SMALL_ICON en una extensión de servicio de notificaciones. Consulte Icono de inicio en la notificación.
¿Puedo cambiar el icono de notificación de iOS por mensaje?
No. iOS siempre usa el icono de su aplicación para las notificaciones push. La carga útil de APNs no tiene campo de icono. Cambiar el icono requiere actualizar el recurso del icono de su aplicación y publicar una nueva versión de la aplicación. Las aplicaciones de mensajería y llamadas pueden mostrar un avatar del remitente solo adoptando Notificaciones de comunicación.¿Qué tamaño debe tener mi icono de web push?
Use una imagen PNG, JPG o GIF no animado cuadrada de256×256 píxeles. Los distintos navegadores y sistemas operativos pueden recortar o escalar el icono, pero 256×256 es el tamaño más consistente entre Chrome, Firefox, Edge y Safari.
¿Puedo usar una URL para el icono pequeño de Android?
No. El icono pequeño de Android debe ser un archivo de recurso local incluido en su aplicación. Solo el icono grande admite URLs remotas.¿Cómo agrego iconos de notificación en Expo?
Use elonesignal-expo-plugin con un PNG de icono pequeño de 96×96 y un PNG de icono grande de 256×256 en app.json o app.config.js. El plugin genera las variantes de densidad en el momento de la compilación. Consulte la pestaña Expo para la configuración.
¿Subo los iconos predeterminados al panel de OneSignal?
No. Los iconos de notificación predeterminados se incluyen dentro del binario de su aplicación, no se cargan en OneSignal. Los agrega a los directorios de recursos de su proyecto (o a la configuración del plugin para Expo), y el SDK de OneSignal los usa automáticamente. El panel de OneSignal solo le permite anular iconos por mensaje para Android y Web Push.Páginas relacionadas
Imágenes y medios enriquecidos
Configuración del SDK de Android
Configuración del SDK React Native / Expo
smallIcons y largeIcons en el plugin Expo de OneSignal.