Skip to content

Media library

The Media Library allows you to manage your assets in a single, centralized location.

You can find the Media Library under Templates.

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

Media Library page that includes an "Upload To Library" section to drag and drop or upload files. There is also a list of uploaded content in the Media Library.

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 1:1 aspect ratio 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.

For more information, refer to In-app message creative details.


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.

Two common ways of accessing the Media Library depending on the message composer. One shows the email Drag and Drop Editor with the title "Images and GIFs" and a button to "Add from Media Library". The other shows the standard editors, such as push and in-app messages, with the title "Media" and a button to "Add Image".

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.

  1. From the Media Library, click AI Image Generator.
  2. Enter a description of the image you want to generate, up to 300 characters. The more detailed the description, the better your result.
  3. Click Generate Images. It can take about a minute for images to generate.
  4. Click on the images you like to add them to your Media Library.

AI image generator modal in the 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.

New Stuff!