Media library
The Media Library allows you to manage your assets in a single, centralized location. To access this feature go into the Media Library tab in the Templates & Media section of your dashboard.
You can use the Media Library to:
- Upload multiple images at one time
- Upload Virtual Contact Files (.vcf)
- Upload a folder with your images (max 50 images)
- Generate an image using AI and store it in the Media Library
- Crop an existing image to create the right ratio for your messages
- Add tags or teams to help further organize your images
- Search by tags or teams in the Media Library grid
- Drag and drop images or folders to be uploaded
- Delete images
For more help with the Media Library, check out our Templates & Media FAQ.
Image details
Within the Media Library, you can see the image type, size, dimensions, URL, and date it was added to the library.
Image specifications
All images uploaded to the Media Library must be less than 5MB. Supported file types are PNG, JPEG, and GIF. For specific image recommendations by messaging channel, refer to the following sections.
Content Cards
Card type | Aspect ratio | Image quality |
---|---|---|
Classic | 1:1 aspect ratio | 60px by 60px |
Captioned | 4:3 aspect ratio | 600px minimum width |
Banner | Any aspect ratio | 600px minimum width |
For more information, refer to Content Card creative details.
Image type | Aspect ratio | Image quality |
---|---|---|
Header image | Any aspect ratio | 600px maximum width |
Body image | Any aspect ratio | 480px maximum width |
Smaller, high quality images will load faster, so we recommend that you use the smallest asset possible to achieve your desired output.
In-app messages
Layout | Aspect ratio | Image quality | Notes |
---|---|---|---|
Image and text | 6:5 aspect ratio | High resolution 1200px by 1000px Minimum resolution 600px by 500px |
Cropping can occur on all sides, but the image will always fill the top 50% of the viewport. |
Image only | 3:5 aspect ratio | High resolution 1200px by 2000px Minimum resolution 600px by 1000px |
Cropping can occur on the left and right edges on taller devices. |
Layout | Aspect ratio | Image quality | Notes |
---|---|---|---|
Image and text | 29:10 aspect ratio | High resolution 1450px by 500px Minimum resolution 600px by 205px |
Tall images will scale down and be horizontally centered. Wide images will be clipped on the left and right edges. |
Image only | Nearly any aspect ratio | High resolution 1200px by 2000px Minimum resolution 600px by 600px |
The message will resize to fit images of most aspect ratios. |
Layout | Aspect ratio | Image quality | Notes |
---|---|---|---|
Image and text | 1:1 aspect ratio | High resolution 150px by 150px Minimum resolution 50px by 50px |
Images of various aspect ratios will fit into a square image container, without cropping. |
For more information, refer to In-app message creative details.
Push
Aspect ratio | Image quality | Notes |
---|---|---|
2:1 aspect ratio (recommended) | 1038px by 1038px maximum | As of January 2020, iOS rich push notifications can handle images 1038px by 1038px as long as they are under 10MB, 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. |
More resources
Android rich notifications do not support GIFs.
Image type | Aspect ratio | Image quality |
---|---|---|
Push icon | 1:1 aspect ratio | N/A |
Expanded notification | 2:1 aspect ratio | Small: 512px by 256px Medium: 1024px by 512px Large: 2048px by 1024px |
Inline image | 3:2 aspect ratio | N/A |
More resources
Accessing the Media Library from a message composer
The Media Library acts as your dashboard’s centralized location for assets, as all images are uploaded directly to it. This lets you re-use images across different messages.
Generate an image using AI
You can generate images for your Media Library using DALL·E 2, an AI system from OpenAI that can create realistic images and art from a description in natural language. Each request generates four variations of your prompt, and your company can generate images 10 times per day. This total applies to all users in your company.
- From the Media Library, click AI Image Generator.
- Enter a description of the image you want to generate, up to 300 characters. The more detailed the description, the better your result.
- Click Generate Images. It can take about a minute for images to generate.
- Click on the images you like to add them to your Media Library.
Between you and Braze, any images generated using DALL·E 2 is your intellectual property. Braze will not assert any claims of copyright ownership on such images and makes no warranty of any kind with respect to any AI-generated content or images.