Web push notification creative guidelines

Web push notifications can be enriched with two image types: icons and pictures.

Icon

The icon is a square image that is always present in the message. By default, the system will use your project logo as icon image.

  • Suggested dimensions: 256x256 px (must be squared)
  • Valid image formats: PNG, JPG (JPEG), GIF
  • Mobile/Desktop differences: GIF animations work only on desktop

Windows (desktop)

Apple (desktop)

Android

Picture

The picture is an optional choice. It is bigger than the icon and is a great tool for marketing contents.

  • Dimensions: 512x256 px (the image can have other sizes but the ratio must be 2:1).
  • Valid image formats: PNG, JPG (JPEG), GIF
  • Mobile/Desktop differences: GIF animations work only on desktop. Different cropping ratios – on desktop images can even be squared, while Android will always crop to a ratio 2:1.

👍

Android cropping

On mobile, Android will crop top and bottom of the image accordingly to the phone screen size. Therefore there is no one specific dimension, but the safe area for the content is in the middle of the image.

Windows 10 (the notification appears in Windows notification centre)

Windows (previous versions of Windows will use the standard Chrome notification)

Android (the cropping of top and bottom areas depend on the phone screen size)

Updated 3 months ago


Web push notification creative guidelines


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.