Upload files to a Media Services account in the Azure portal

media services logo


Update your Azure Media Services REST API and SDKs to v3 by 29 February 2024. Version 3 of Azure Media Services REST API and client SDKs for .NET and Java offers more capabilities than version 2. We’re retiring version 2 of the Azure Media Services REST API and client SDKs for .NET and Java.

Action Required: To minimize disruption to your workloads, review the migration guide to transition your code from the version 2 API and SDKs to version 3 API and SDK before February 29th, 2024. After February 29th, 2024, Azure Media Services will no longer accept traffic on the version 2 REST API, the ARM account management API version 2015-10-01, or from the version 2 .NET client SDKs. This includes any 3rd party open-source client SDKS that may call the version 2 API. Learn about the latest version, starting with the Media Services v3 Overview.


No new features or functionality are being added to Media Services v2. See Media Services v3. Also, see migration guidance from v2 to v3

In Azure Media Services, you upload your digital files to an asset. The asset can contain video, audio, images, thumbnail collections, text tracks, and closed caption files (and the metadata for these files). After the files are uploaded, your content is stored securely in the cloud for further processing and streaming.

Media Services has a maximum file size for processing files. For details about file size limits, see Media Services quotas and limitations.

To complete this tutorial, you need an Azure account. For details, see Azure free trial.

Upload files

  1. In the Azure portal, select your Azure Media Services account.

  2. Select Settings > Assets. Then, select the Upload button.

    Upload files

    The Upload a video asset window appears.


    Media Services doesn't limit the file size for uploading videos.

  3. On your computer, go to the video that you want to upload. Select the video, and then select OK.

    The upload begins. You can see the progress under the file name.

When the upload is finished, the new asset is listed in the Assets pane.