Overview
You can use videos to represent your NFTs in the marketplace. This guides details the supported media types in the Immutable marketplace and includes an FAQ section.
Supported media types
Immutable supports three media types for videos:
application/vnd.apple.mpegurl
(HLS)video/mp4
video/webm
Check our developer docs for the latest list of supported types.
Note: The supported media types can vary across marketplaces and client browsers.
Including a video in your NFT metadata
In order to use a video with your NFT, you will need to host the video and make it accessible via a URL. You will need to specify the URL and the media type in your metadata with the following properties:
animation_url
animation_url_mime_type
You can encode your video in any supported web format, but we recommend using HLS for the best performance.
HLS
HTTP Live Streaming or HLS is a protocol developed by Apple to stream audio and video over the internet. It is the most popular streaming format.
HLS leverages adaptive bitrate streaming to automatically adjust video quality based on a user's internet speed and device performance. By serving different bitrate streams, HLS makes sure users get smooth video playback, even if network conditions change.
To use this format, include these fields in your metadata:
animation_url: <location of your multivariant playlist>
animation_url_mime_type: application/vnd.apple.mpegurl
MP4
MP4 is a widely used video format and usable on any device regardless of the platform, network, or browser. It maintain its quality even when compressed into a smaller file size.
To use this format, include these fields in your metadata:
animation_url: <location of your video file>
animation_url_mime_type: video/mp4
Webm
Webm is a royalty-free format sponsored by Google. It was initially designed for playing on browser embedded media players, which aims to make online video streaming possible on different devices.
To use this format, include these fields in your metadata:
animation_url: <location of your video file>
animation_url_mime_type: video/webm
FAQ
Can I use GIFs?
Yes, you can use GIFs instead of videos by specifying the GIF url in image_url
. However, GIFs have a much larger file size compared to videos with the same content. If file size and resolution matter, use videos or HLS.
What is the recommended video format?
We recommend HLS for high resolution videos and a better UX.
Which video encoding should I use for HLS?
HLS supports both H.264 and H.265, but H.264 has better support by browsers.