Media

All Media files for Umbraco Cloud projects are stored in Azure Blob Storage containers. Each environment has a separate container linked to it.

All media files on your Umbraco Cloud projects are stored using Azure Blob Storage. This means that the media files are not stored with the rest of your project files but in an external storage system.

To access the media files on your Umbraco Cloud project you can either:

About Azure Blob Storage

Azure Blob Storage is an external storage system, that the Umbraco Cloud service uses to store all media files on Umbraco Cloud projects. To learn how you can connect to your Blob Storages, read the Azure Blob Storage article.

Working with media locally

When cloning a Cloud environment to your local machine, run a content restore from the backoffice. This will retrieve a copy of all the media files from the Azure Blob Storage container connected to that environment.

You can learn more about how this works in the Restoring content article.

Adding new media files to your local clone automatically uploads to the Azure Blob Storage container connected to the environment you are deploying to.

One Storage per Environment

Each environment on your Umbraco Cloud project has a separate Azure Blob Storage container. Each of your environments uses a storage container specific to that environment.

When you deploy between two environments on your Umbraco Cloud project, media files will be copied from one storage to the other. The files are transferred depending on which environment you are moving to and from.

As an example, consider a scenario where you are transferring content changes from your left-most mainline environment to your Live environment. Initiating the transfer copies all media files from your left-most mainline environment Azure Blob Storage container to the Live environment container. Once all content changes have been successfully transferred and the process is complete, the media libraries in both environments will be synchronized.

Media Folder

You will notice that there is a Media (wwwroot/media) folder in your project files. This folder usually holds all media files associated with a Umbraco project. As your Umbraco Cloud environments are all configured with Azure Blob Storage, the media files are not in this media folder.

Instead, you will find a project.assets.json file in the obj folder. This file is used to connect the Media library on your Cloud environment to an Azure Blob Storage container.

Environment Variables

In some cases, you might want to connect to your Azure Blob Storage container for the environments on your Umbraco Cloud project. This could be to clean up unwanted media files or to download the current contents of the library.

Instead of connecting to Azure Blob Storage, you can clone your Cloud environment locally to access the files.

You should only use the following approach when you do not have the option to clone down the environment to your local machine.

To do this, you need to know some details about the connection between the environment and the Azure Blob Storage containers. Below are the steps you need to follow, to locate the necessary variables:

  1. Access Kudu on your Cloud environment.

  2. Locate the Environment page in the top navigation.

  3. Scroll to the section containing Environment variables.

There are 4 variables related to the Azure Blob Storage container in your environment:

  • APPSETTING_UMBRACO__CLOUD__STORAGE__AZUREBLOB__CONTAINERALIAS

  • APPSETTING_UMBRACO__CLOUD__STORAGE__AZUREBLOB__CONTAINERNAME

  • APPSETTING_UMBRACO__CLOUD__STORAGE__AZUREBLOB__ENDPOINT

  • APPSETTING_UMBRACO__CLOUD__STORAGE__AZUREBLOB__SHAREDACCESSSIGNATURE

Once you have the variables, use the "Connect to Azure Storage Explorer" guide to connect to your storage container.

Last updated

Was this helpful?