Getting Started
Microsoft Azure

Adding a Microsoft Azure Source

A Microsoft Azure Source connects to an existing Microsoft Azure storage account. imgix connects using the credentials you supply, so assets do not have to be public.

Setting Up Your Microsoft Azure Source

  1. Go to the Sources page (opens in a new tab) in the imgix dashboard and click the New Source button.

  2. Select Microsoft Azure How do you store your media? radio options.

Screenshot-Azure source setup

  1. Fill in the details for your Microsoft Azure Source.

Screenshot-Azure source setup

Note: We strongly recommend generating a SAS Token specifically for imgix to access your assets with. Keep in mind that imgix only requires Read and List permissions to begin serving your assets. For more information on how to generate your SAS Token or where to find your Azure account details see the Microsoft Azure Guide documentation.

  • Storage Account Name: The account name for the storage account containing the assets you want imgix to connect to.
  • Storage Account Type: Select File Share or Container (Blob) as appropriate.
  • Container/File Share Name: The name of your Container or File Share.
  • SAS Token: A shared access signature (SAS) for the storage account deployment_credentials you want imgix to connect with.
  • Path Prefix (optional): The folder prefix you want to resolve to (if it exists). The prefix is prepended to the asset path before resolving the asset in Azure. By default the asset path is /.
  1. Choose the Subdomain you would like to use as the base URL for your assets.

Screenshot-Azure source setup

Note: The subdomain name you choose is unique to your Source and can't be re-used. If you're setting up a Source with a lot of customization (particularly a Custom Domain), choose the name you plan to use going forward.

  • If you are editing an existing Source and the Video API is enabled, the imgix Video Subdomain field will be visible. This field automatically inherits the value from your imgix Image Subdomain and cannot be modified without changing the Image Subdomain.
  1. Click the Save button on Step #3 to queue your Source for deployment.

Screenshot-Azure source setup

Note: By default Azure File Share assets have the Content-Type application/octet-stream, which will cause an asset to be downloaded instead of opened directly in the browser when served via imgix without any parameters. To solve this you can add any imgix parameter (such as auto=compress) to the URL or add a default parameter to your Source post-deployment.

Microsoft Azure Guide

We strongly recommend creating a SAS Token specifically for imgix to access your assets with.

Advanced Settings

See the Advanced Source Settings for information about setting up custom domains, defaults, and cache TTL options.


To upload images and videos directly to your cloud-storage-backed Microsoft Azure Source, you will have to create a separate set of upload_credentials. Uploading should only be set up post-Source-deployment.

imgix’s rendering service does not need Write permissions to fetch assets; therefore, we highly recommend that you do not use the same credentials for your upload_credentials and your deployment_credentials.