How to upload, manage, and use media library content
Last updated: March 13, 2025
Overview
The media library stores images, videos, and audio files for use in emails, MMS messages, and forms.
Read on to learn how to add files to the media library and use them in messages and forms.
Accepted file types and size limits
Files from the media library can be used in emails, SMS messages, forms, and your reviews store owner avatar icon.
The table below describes the file types accepted by the media library and where each file type is accepted. The maximum accepted file size is in parentheses in the column headers.
File type | Email (10.5MB) | SMS (512KB) | Forms (10.5MB) | Reviews store owner avatar icon (500KB) |
JPG | ✅ | ✅ | ✅ | ✅ |
JPEG | ✅ | ✅ | ✅ | ✅ |
GIF | ✅ | ✅ | ✅ | ✅ |
PNG | ✅ | ✅ | ✅ | ✅ |
SVG | ✅ | |||
WEBP | ✅ | ✅ | ||
AC3 | ✅ | |||
MP3 | ✅ | |||
WAV | ✅ | |||
MP4 | ✅ |
Access the media library
In the lefthand sidebar, click the Content Library icon
Click Media Library
Add and delete files in the media library
You can add files to the media library on the media library page, an image element in an email builder, or the image selector in the SMS builder.
File names must be unique
Add a file on the media library page
To add a file on the media library page:
Navigate to the media library
Click Upload
Choose your upload source
File
Click the file finder
Select the file from your device
URL
Click the URL tab
Paste your media's URL
Create or select a category*
Click Save
*Files without an associated category are considered uncategorized and will not appear if any categories are selected on the media library page's category filter.
Add to the media library from the visual email builder
To add an image to the media library from an image element in the visual email builder:
Click on an image element
Ensure that the Add media to media library checkbox is checked
Click the file finder
Select your image file (video and audio files are not available for email)
Add to the media library from the text email builder
To add an image to the media library from the text email builder:
Click the image icon
Click file upload
Ensure that the Add media to media library checkbox is checked
Click the file finder
Select your file
Delete a file from the media library
Deleted files will still appear in any draft messages they existed in at the time of deletion, but they will not be visible in the media library after deletion.
To delete a file:
Navigate to the media library
Search for the file you want to delete
Click the trash can icon next to the file
Click Delete
Use media library files
SMS message
Note that when the media library is opened from the SMS message builder, files larger than the SMS limit of 500kB are not shown.
To add media to an SMS message:
Click the MMS icon
Click Media Library
Select a file
Visual builder email
To add media to an email in the visual builder:
Insert an image block
Click the image block
Click media library
Click image to insert
Text email
To add media to an email in the text builder:
Place your cursor where you want the media to be inserted
Click the image icon
Click media library
Click image to insert
HTML email
To add media to an email in the HTML builder:
Click the Content Library icon in the main sidebar
Click Media Library
Find the file you want to insert
Click the view icon next to your file
Click Copy URL
Insert the URL into your email's HTML using the following tag:
<img src="INSERT_URL_HERE" alt="INSERT_ALT_TEXT_HERE">. You can specify a height and width for your image by adding width and height properties to the tag:<img src="INSERT_URL_HERE" alt="INSERT_ALT_TEXT" width="500" height="600">
Form
To add media to a form:
Add an image block
Click file upload
Click media library
Click an image to insert it
Reviews store owner avatar icon
To use a file from the media library as your store owner avatar icon:
In the left-hand navigation bar, click the Product Reviews icon
Click Content
Click Store Profile
Check the Avatar Icon checkbox
Click File Upload
Click Media Library
Search for a file
Click Insert