All Collections
NFT Metadata
Video NFTs in the Immutable marketplace
Video NFTs in the Immutable marketplace

Learn about the supported media types for video NFTs

Jeffy avatar
Written by Jeffy
Updated over a week ago

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.

Did this answer your question?