Skip to content

Image specifications

In general, smaller and high-quality images will load faster, so we recommend using the smallest asset possible to achieve your desired output. To maximize your image use in specific channels, refer to the details in this article.

You should always preview and test your messages on a variety of devices to confirm that the most important areas of your image and message appear as expected.

We recommend the following payload sizes:

Messaging system Recommended payload
iOS (pre-iOS 8) 0.256 KB
iOS (post-iOS 8) 2 KB
Android (FCM) 4 KB

In-app messages

Modal in-app messages are designed to fit the device at the best and most filling ratios possible, while staying true to the size and ratios of your chosen image or copy for your message.

While there are no limits to how many text characters you can include in an in-app message (as well as buttons, headline, main body, and others), we moderate how many text characters you use. Too much text will require users to expand and scroll the message.

All in-app messages have a recommended image size of 500 KB, maximum image size of 5 MB, and support PNG, JPG, and GIF file types.

Type Aspect ratio Image quality Notes
Portrait full screen with text 6:5 High resolution 1200 x 1000 px
Minimum resolution 600 x 500 px
Cropping can occur on all sides, but the image will always fill the top 50% of the viewport.
Portrait full screen (image only, with or without buttons) 3:5 High resolution 1200 x 2000 px
Minimum resolution 600 x 1000 px
Cropping can occur on the left and right edges on taller devices.
Type Aspect ratio Image quality Notes
Landscape full screen with text 10:3 High resolution 2000 x 600 px
Minimum resolution 1000 x 300 px
Cropping can occur on all sides, but the image will always fill the top 50% of the viewport.
Landscape full screen (image only, with or without buttons) 5:3 High resolution 2000 x 600 px
Minimum resolution 1000 x 600 px
Cropping can occur on the left and right edges on taller devices.
Type Aspect ratio Image quality Notes
Slideup 1:1 High resolution 150 x 150 px
Minimum resolution 50 x 50 px
Images of various aspect ratios will fit into a square image container, without cropping.

Font Awesome

Braze supports using Font Awesome v4.3.0 for modal in-app message icons.

Push notifications

Message type Maximum message length Maximum title length
iOS lock screen 175 characters 43 characters
iOS notification 175 characters 43 characters
iOS banner alert 85 characters 43 characters
Android lock screen 49 characters 43 characters
Android notification drawer 597 characters 43 characters

The recommended image size for all push images is 500 KB.

Image type Aspect ratio Image quality Maximum image size File types Notes
iOS 2:1 (recommended) 1038 x 1038 px maximum 5 MB PNG, JPG, GIF As of January 2020, iOS rich push notifications can handle images 1038 x 1038 px as long as they are under 10 MB, but we recommend using as small a file size as possible. In practice, sending large files can cause both unnecessary network stress and make download timeouts more common.

For more information, see iOS rich notifications.
Android push icon 1:1 N/A 500 KB PNG, JPG
Android expanded notification image 2:1 Small: 512 x 256 px
Medium: 1024 x 512 px
Large: 2048 x 1024 px
500 KB PNG, JPG Used in Android rich notifications.
Android incline image 3:2 N/A N/A PNG, JPG For more details, see Android inline image push.

Email

Email type Recommended maximum properties
Text only 25 KB
Text with images 60 KB
Email width 600 px
Image specifications Recommended maximum properties
Size 5 MB
Width Header: 600 px
Body: 480 px
File types PNG, JPG, GIF
Text specifications Recommended maximum properties
Subject line length 35 characters
6 to 10 words
"From: Name" length 25 characters
Pre-header length 85 characters

Image behavior

Layout Behavior
Image and text Tall or narrow images will scale down and be horizontally centered. Wide images will be clipped on the left and right edges.
Image only The message will resize to fit images of most aspect ratios.
HOW HELPFUL WAS THIS PAGE?
New Stuff!