The Media Manager API allows you to manage media files and folders in a site's Media Manager.
With the Media Manager API, you can:
Learn more about the Media Manager and how you can access it.
Before using the Import File and Bulk Import Files endpoints, see the article on Importing Files.
Generate File Download Url vs. Generate Files Download Url
The Generate Files Download Url generates a permanent URL for downloading a compressed file containing specific files in the Media Manager. However, the Generate File Download Url generates one or more temporary URLs for downloading a specific file in the Media Manager. You can use the expirationInMinutes
parameter to set the URL expiration time, making it more secure than the Generate Files Download Url. Therefore, to download private files, use the Generate File Download Url for each private file that you want to generate a download Url for, instead of the Generate Files Download Url.
Generate File Resumable Upload Url vs. Generate File Upload Url The Generate File Upload Url generates an upload URL to allow external clients to upload a file to the Media Manager. However, any interruption in the upload process stops the file upload. For files larger than 10MB, or when network connection is poor, use the Generate File Resumable Upload Url instead. With the resumable upload URL, any interruption in the upload process pauses the file upload, and resumes the file upload process after the interruption.
Using the generated upload and resumable upload URLs
When you get the uploadUrl
response from Generate File Upload Url, learn how you can use it to upload a file to the Media Manager. When you get the uploadUrl
response from Generate File Resumable Upload Url, learn how you can use it to resumably upload a file to the Media Manager.
System folders: Folders in the Media Manager's file system directory. There are 3 types of system folders:
Root Folders: Main categories of folders the Media Manager.
MEDIA_ROOT
: Contains all files and folders in the Media Manager's 'Site Files' tab in the UI.
Note: The
MEDIA_ROOT
system folder is different from themedia-root
folder of the Media Manager. TheMEDIA_ROOT
system folder contains all media in all levels of the 'Site Files' tab in the UI, while themedia-root
folder of the Media Manager only contains the media in the root level of the 'Site Files' tab in the UI.
TRASH_ROOT
: Contains all files and folders in the Media Manager's 'Trash' tab in the UI.
VISITOR_UPLOADS_ROOT
: Contains all files and folders created by site visitors or members.
Note: The
VISITOR_UPLOADS_ROOT
folder is located in the 'Site Files' tab in the UI. However, it is its own root folder and doesn't return when searching in theMEDIA_ROOT
folder.
Virtual Folders: Special categories of folders in the Media Manager that are hidden from the UI and can't be deleted.
MOBILE_UPLOADS
: Contains all media uploaded using mobile devices.PURCHASED_ITEMS
: Contains all media imported using a purchase flow.Other Folders:
VIDEO_MAKER
: Contains all videos created using Wix Video Maker. Located in the 'Site Files' tab in the UI.
File Assets Wix Media files are optimized for web use. When a file is imported or uploaded to the Media Manager, it is processed and may produce several variations of the file for use in different circumstances.
For example:
With the Generate File Download Url, you can use the assetKeys
parameter to download different assets of a file.