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 video files for use in WhatsApp messages
• 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

Image details

Within the media library, you can see the asset type, size, dimensions, URL, the date it was added to the library, and other information.

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, GIF, and SVG. 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.

Email

Email type	Recommended maximum properties
Text only	25 KB
Text with images	60 KB
Email width	600 px

Image specifications	Recommended maximum properties
Size	5 MB
Width	Header: 600 px Body: 480 px
File types	PNG, JPEG, GIF

Text specifications	Recommended maximum properties
Subject line length	35 characters 6 to 10 words
"From: Name" length	25 characters
Pre-header length	85 characters

In-app messages

Modal in-app messages are designed to fit the device at the best and most filling ratios possible, while staying true to the size and ratios of your chosen image or copy for your message.

While there are no limits to how many text characters you can include in an in-app message (as well as buttons, headline, main body, and others), we moderate how many text characters you use. Too much text will require users to expand and scroll the message.

All in-app messages have a recommended image size of 500 KB, maximum image size of 5 MB, and support PNG, JPEG, and GIF file types.

• portrait
• landscape
• slideup
• modal

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

Push

Message type	Maximum message length	Maximum title length
iOS lock screen	175 characters	43 characters
iOS notification	175 characters	43 characters
iOS banner alert	85 characters	43 characters
Android lock screen	49 characters	43 characters
Android notification drawer	597 characters	43 characters

The recommended image size for all push images is 500 KB.

Image type	Aspect ratio	Image quality	Maximum image size	File types	Notes
iOS	2:1 (recommended)	1038 x 1038 px maximum	5 MB	PNG, JPEG, GIF	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. For more information, see iOS rich notifications.
Android push icon	1:1	N/A	500 KB	PNG, JPEG
Android expanded notification image	2:1	Small: 512 x 256 px Medium: 1024 x 512 px Large: 2048 x 1024 px	500 KB	PNG, JPEG	Used in Android rich notifications.
Android incline image	3:2	N/A	N/A	PNG, JPEG	For more details, see Android inline image push.

More resources

• Push image and text specifications

Video

Videos that are uploaded to the media library can only be used in WhatsApp messages for now. For more information, refer to Creating a Whatsapp Message.

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 reuse images across different messages.

Generate an image using AI

You can generate images for your media library using DALL·E 3, an AI system from OpenAI, a Braze third-party provider. This system 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, select 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. This feature only supports text input—uploading an image as a reference isn’t available.
3. Select Generate Images. It can take about a minute for images to generate.
4. Select on the images you would like to add to your media library.

Between you and Braze, any images generated using DALL·E 3 are 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.

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.