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.
Create assets with confidence! Our in-app message image templates and safe-zone overlays are designed to play nicely with devices of all sizes. Download Design Templates ZIP.
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 |
|---|---|---|---|
| Modal (image only) | 1:1 | High resolution 1200 x 2000 px Minimum resolution 600 x 600 px |
The message will resize to fit images of most aspect ratios. |
| Modal with text | 29:10 | High resolution 1450 x 500 px Minimum resolution 600 x 205 px |
Tall images will scale down and be horizontally centered. Wide images will be clipped on the left and right edges. |
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 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. |
Edit this page on GitHub