Skip to content

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

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.

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 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.


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.

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.

New Stuff!