Skip to content

Media library

The media library allows you to manage your assets in a single, centralized location.

Media library vs. CDN

Using the media library instead of a Content Delivery Network (CDN) 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.

Accessing the media library

Within the media library, you can see the asset type, size, dimensions, URL, the date it was added to the library, and other information. To access your Braze media library, go to THIS > Templates. Here, you can:

  • 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

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.

Later when drafting a message in Braze, you can pull in your images from the media library.

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

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.

Type Aspect ratio Image quality Notes
Portrait full screen with text 6:5 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.
Portrait full screen (image only, with or without buttons) 3:5 High resolution 1200 x 2000 px
Minimum resolution 600 x 1000 px		 Cropping can occur on the left and right edges on taller devices.
Type Aspect ratio Image quality Notes
Landscape full screen with text 10:3 High resolution 2000 x 600 px
Minimum resolution 1000 x 300 px		 Cropping can occur on all sides, but the image will always fill the top 50% of the viewport.
Landscape full screen (image only, with or without buttons) 5:3 High resolution 2000 x 600 px
Minimum resolution 1000 x 600 px		 Cropping can occur on the left and right edges on taller devices.
Type Aspect ratio Image quality Notes
Slideup 1:1 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.
Type Aspect ratio Image quality Notes
Modal (image only) 1:1 High resolution 1200 x 2000 px
Minimum resolution 600 x 600 px		 The message will resize to fit images of most aspect ratios.
Modal with text 29:10 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.

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.

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.

Generating images with BrazeAITM

You can generate images for your own media library using DALL·E 3, an AI system from OpenAI and a Braze third-party provider. This let’s you 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.

Github   Edit this page on GitHub
HOW HELPFUL WAS THIS PAGE?
New Stuff!