Images in messages
Our SDK does a lot of work behind the scenes to fit your images into our message templates. Depending on the type of message you are sending, your image may be letterboxed or cropped to fit.
For example, images with a set width and height will letterbox to ensure they fit in the message. Full-screen messages, however, may crop images fit different device sizes. To prevent letterboxing or cropping, take a look at image size recommendations below.
Test on a real device 📲
Even if you follow our image size recommendations, make sure you test all messages on a real device to ensure that everything looks exactly how you want it to.
| Message type | Image size recommendations | Example image |
|---|---|---|
| Push Notifications | Push images: Android requires an aspect ratio of 2:1. iOS 12 requires an aspect ratio of 1:1 or 3:2. Other sizes of images will be trimmed to fit these guidelines. File size may not exceed 1MB. See here for details on using images in push. |  |
| Center Popup | Background Image: Matches the width/height of the message (defaults to 300:250px). Images that don't match the width:height of your message will shrink or stretch to fit. |  |
| Push Pre-Permission | Background Image: Matches the width/height of the message (defaults to 300:250px). Images that don't match the width:height of your message will shrink or stretch to fit. |  Tip: For a hero-image effect, add a blank section for text to the bottom of your background image. See example here. |
| Interstitial | Full-screen background image: Fits the image to the size of the device's screen. Images may be cropped to fit the user's screen, depending on how the image size compares to the user's device. We recommend localizing your message to different devices to prevent cropping. |  Tip: See the screen sizes for different iOS and Android devices. Try to optimize your image size for some of the more popular devices. |
| Star rating | Hero Image option: Height is fixed at 140px and the width is 100% of the message width (defaults to 340px). So, for best results, use an image with an aspect ratio of 340:140. Tip: Remember, changing the message width will change the hero image's aspect ratio. Widening to 400px, for example, would change the required ratio to 400:140. Background Image option: Matches the width:height the of message (including the button). Default width:height is 340:230px. Images that don't fit the aspect ratio of the message will shrink to fit, which may create blank spaces/ edges. | Hero image: Background image:  |
| Rich interstitial | Hero Image option: Height is fixed at 140px and the width is 100% of the message width (defaults to 340px). So, for best results, use an image with an aspect ratio of 340:140. Tip: Remember, changing the message width will change the hero image's aspect ratio. Widening to 400px, for example, would change the required ratio to 400:140. Background Image option: Matches the width:height the of message (including the button). Default width:height is 340:230px. Images that don't fit the aspect ratio of the message will shrink to fit, which may create blank spaces/ edges. | Hero image: Background image:  |
| Banner (rich) | Hero image option (appears on side of banner text): The width of the hero image is fixed at 100px and the height is set to 100% of the message height (defaults to 60px). So, for best results, use an image with an aspect ratio of 100:60. Remember, changing the message height will change the hero image's aspect ratio. Increasing to 70px, for example, would change the required ratio to 100:70. Background image option: Height is fixed at 60px and the width is 100% of the message by default. To account for different device sizes, the background image will be letterboxed on some devices or in landscape orientation. For consistent results, set the message width equal to the image width. This will ensure the full image is always displayed (on devices wide enough to display it). | Hero image: Background image:  |
Updated over 3 years ago