Media library
The Media Library allows you to manage your assets in a single, centralized location.
You can find the Media Library under Templates.
If you are using the older navigation, this page is located under Templates & Media.
You can use the Media Library to:
- Upload multiple images at one time
- Upload Virtual Contact Files (.vcf)
- Upload a folder with your images (maximum 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.
Using the Media Library versus a CDN
Using the Media Library provides better caching and performance for in-app messages. All Media Library assets found in an in-app message will be pre-cached for faster display and will be available for offline display. Additionally, the Media Library is integrated with Braze composers, allowing marketers to select or tag images instead of copying and pasting image URLs.
Image specifications
All images uploaded to the Media Library must be less than 5 MB. 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 | 60 x 60 px |
| Captioned | 4:3 aspect ratio | 600 px minimum width |
| Banner | Any aspect ratio | 600 px minimum width |
For more information, refer to Content Card creative details.
| Image type | Aspect ratio | Image quality |
|---|---|---|
| Header image | Any aspect ratio | 600 px maximum width |
| Body image | Any aspect ratio | 480 px 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 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. |
| Image only | 3:5 aspect ratio | High resolution 1200 x 2000 px Minimum resolution 600 x 1000 px |
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 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. |
| Image only | Nearly any aspect ratio | High resolution 1200 x 2000 px Minimum resolution 600 x 600 px |
The message will resize to fit images of most aspect ratios. |
For more information, refer to In-app message creative details.
Push
| Aspect ratio | Image quality | Notes |
|---|---|---|
| 2:1 aspect ratio (recommended) | 1038 x 1038 px maximum | 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. |
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: 512 x 256 px Medium: 1024 x 512 px Large: 2048 x 1024 px |
| 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.
In order to generate images, Braze will send your query to OpenAI’s API Platform. All queries sent to OpenAI from Braze are anonymized, meaning that OpenAI will not be able to identify from whom the query was sent unless you include uniquely identifiable information in the input you provide. As detailed in OpenAI’s API Platform Commitments, data sent to OpenAI’s API via Braze is not used to train or improve their models and will be deleted after 30 days. Please ensure that you adhere to OpenAI’s policies relevant to you, which may include its Usage Policy and its Sharing & Publication Policy. Braze makes no warranty of any kind with respect to any AI-generated content.
Edit this page on GitHub