Media library

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

Prerequisites

Requirements	Description
“View Media Library Assets” permission	View media library assets
“Edit Media Library Assets” permission	Create and update media library assets
“Delete Media Library Assets” permission	Permanently delete media library assets
“Replace Media Library Assets” permission	Replace the file of an existing media library asset while keeping its URL and asset ID stable

For more information, see User permissions.

Media library versus 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 Content > Media Library. 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 (up to 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
• Replace the file of an existing asset while keeping its URL stable
• 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

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

Replace a file

You can replace the file of an existing asset in the media library while keeping its URL and asset ID stable. Because the URL doesn’t change, any message or campaign that references that asset—including already-sent emails—automatically reflects the updated file. This is useful when you want to update a shared asset (such as a logo) in one place rather than updating every campaign individually.

To replace an asset, you must have the “Replace Media Library Assets” permission:

1. Go to Content > Media Library.
2. Select the asset you want to replace.
3. In the modal, select Replace file.
4. Upload the replacement file.

Requirements and limitations

• The replacement file must have the same file extension as the original. For example, you can’t replace a .png asset with a .jpg file.
• Video assets cannot be replaced.
• After replacement, the updated file may take some time to display for all consumers due to CDN caching.

Channels with processed image copies

Some channels create an optimized copy of the image when the message is set up, resulting in a separate URL. Replacing the original media library asset does not update what consumers see for messages created using those channels, including in-app messages, Content Cards, push notifications, and banners.

You can also replace an asset programmatically using the PUT /media_library/replace_file endpoint.

Image specifications

All images uploaded to the media library must be less than 5 MB. Supported file types are PNG, JPEG, GIF, SVG, and WebP. For recommended image sizes and specifications by messaging channel, refer to Image specifications.

Generating images with BrazeAI^TM

You can generate images for your own media library using GPT Image 2.0, 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.